[ { "path": ".gitignore", "content": "# Eclipse Metadata \n.project\n.classpath\n.settings\n\n# Assets\n/bin/\n/Handy/handy.zip\n\n" }, { "path": "Handy/examples/simple1/simple1.pde", "content": "import org.gicentre.handy.*; // For Handy rendering.\n\n// Displays a simple rectangle in a hand-drawn style.\n// Version 2.0, 4th April, 2016\n// Author Jo Wood\n\nHandyRenderer h; // This does all the hard work of rendering.\n\n// Set up the sketch and renderer.\nvoid setup()\n{\n size(400,250); \n h = new HandyRenderer(this); // Creates the renderer.\n}\n\n// Draw a rectangle in a sketchy style\nvoid draw()\n{\n background(247,230,197);\n h.rect(width/4,height/4,width/2,height/2);\n \n noLoop(); // No need to redraw.\n}" }, { "path": "Handy/examples/simpleColourStyles/simpleColourStyles.pde", "content": "import org.gicentre.handy.*;\n\n// Displays 4 sktechy rectangles with different fill styles.\n// Version 2.0, 4th April, 2016\n// Author Jo Wood\n\nHandyRenderer h;\n\nvoid setup()\n{\n size(300,200);\n h = new HandyRenderer(this);\n h.setOverrideFillColour(true);\n h.setOverrideStrokeColour(true);\n}\n\nvoid draw()\n{\n background(247,230,197);\n\n h.setBackgroundColour(color(255));\n h.setFillColour(color(206,76,52));\n h.setStrokeColour(color(0));\n h.rect(50,30,80,50);\n \n h.setBackgroundColour(color(255,130));\n h.rect(170,30,80,50);\n \n h.setBackgroundColour(color(0,0)); \n h.setStrokeColour(color(206,76,52)); \n h.rect(50,120,80,50);\n \n h.setBackgroundColour(color(206,76,52)); \n h.setFillColour(color(19,39,28));\n h.setStrokeColour(color(200,70,48));\n h.rect(170,120,80,50); \n \n noLoop(); // No need to redraw.\n}" }, { "path": "Handy/examples/simpleHachureStyles/simpleHachureStyles.pde", "content": "import org.gicentre.handy.*;\n\n// Displays 4 sketchy rectangles with different hachuring styles.\n// Version 2.0, 4th April, 2016\n// Author Jo Wood\n\nHandyRenderer h;\n\nvoid setup()\n{\n size(300,200);\n h = new HandyRenderer(this);\n fill(206,76,52);\n h.setHachurePerturbationAngle(15);\n}\n\nvoid draw()\n{\n background(247,230,197);\n h.setRoughness(1);\n\n h.setFillGap(0.5);\n h.setFillWeight(0.1);\n h.rect(50,30,80,50);\n\n h.setFillGap(3);\n h.setFillWeight(2);\n h.rect(170,30,80,50);\n\n h.setFillGap(5);\n h.setIsAlternating(true);\n h.rect(50,120,80,50);\n\n h.setRoughness(3); \n h.setFillWeight(1);\n h.setIsAlternating(false);\n h.rect(170,120,80,50);\n \n noLoop(); // No need to redraw.\n}" }, { "path": "Handy/examples/simplePresetStyles/simplePresetStyles.pde", "content": "import org.gicentre.handy.*;\n\n// Displays 4 sets of sketchy rectangles each with their own preset styles.\n// Version 2.0, 4th April, 2016\n// Author Jo Wood\n\nHandyRenderer h1,h2,h3,h4;\n\nvoid setup()\n{\n size(610,200);\n h1 = HandyPresets.createPencil(this);\n h2 = HandyPresets.createColouredPencil(this);\n h3 = HandyPresets.createWaterAndInk(this);\n h4 = HandyPresets.createMarker(this);\n}\n\nvoid draw()\n{\n background(247,230,197);\n \n for (int i=0; i<5; i++)\n {\n fill(206+random(-30,30),76+random(-30,30),52+random(-30,30),160);\n h1.rect(random(10,200),random(10,50),80,50);\n h2.rect(random(310,520),random(10,50),80,50);\n h3.rect(random(10,200),random(100,140),80,50);\n h4.rect(random(310,520),random(100,140),80,50); \n }\n \n noLoop(); // No need to redraw.\n}" }, { "path": "Handy/examples/stickFigure/stickFigure.pde", "content": "import org.gicentre.handy.*; // For hand-drawn rendering.\n\n// Creates a simple stick figure using sketchy graphics\n// Version 2.0, 4th April, 2016.\n// Author Jo Wood, giCentre, City University London.\n\nHandyRenderer h; // This does the sketchy drawing.\n\nArrayList joints;\nint movingJoint; // Index of the joint currently being moved by mouse.\n\n\nvoid setup()\n{\n size(600,400);\n strokeWeight(3);\n noFill();\n h = new HandyRenderer(this); // Initialise the handy renderer.\n\n movingJoint = -1;\n \n joints = new ArrayList();\n joints.add(new PVector(width/2+10,height/2-20)); // head\n joints.add(new PVector(width/2,height/2)); // Neck\n joints.add(new PVector(width/2,height/2+50)); // Pelvis\n joints.add(new PVector(width/2+2,height/2+90)); // Left knee\n joints.add(new PVector(width/2+20,height/2+90)); // Right knee\n joints.add(new PVector(width/2-20,height/2+130)); // Left ankle\n joints.add(new PVector(width/2+20,height/2+130)); // Right ankle\n joints.add(new PVector(width/2-10,height/2+130)); // Left toe\n joints.add(new PVector(width/2+30,height/2+130)); // Right toe\n joints.add(new PVector(width/2-20,height/2+35)); // Left elbow\n joints.add(new PVector(width/2+10,height/2+40)); // Right elbow\n joints.add(new PVector(width/2-15,height/2+70)); // Left wrist\n joints.add(new PVector(width/2+40,height/2+70)); // Right wrist\n joints.add(new PVector(width/2-12,height/2+70)); // Left finger \n joints.add(new PVector(width/2+42,height/2+70)); // Right finger\n}\n\nvoid draw()\n{\n background(255);\n h.setSeed(1234); // Set this if you don't wish to see minor varations on each redraw.\n\n h.rect(30,30,width-60,height-60);\n \n float tilt = atan2(joints.get(1).x-joints.get(0).x,joints.get(1).y-joints.get(0).y);\n pushMatrix();\n translate(joints.get(1).x,joints.get(1).y);\n rotate(-tilt);\n h.ellipse(0,-25,40,50); // Head\n popMatrix();\n \n h.line(joints.get(1).x,joints.get(1).y,joints.get(2).x,joints.get(2).y); // Body\n h.line(joints.get(2).x,joints.get(2).y,joints.get(3).x,joints.get(3).y); // Left femur\n h.line(joints.get(2).x,joints.get(2).y,joints.get(4).x,joints.get(4).y); // Right femur\n h.line(joints.get(3).x,joints.get(3).y,joints.get(5).x,joints.get(5).y); // Left shin\n h.line(joints.get(4).x,joints.get(4).y,joints.get(6).x,joints.get(6).y); // Right shin\n h.line(joints.get(5).x,joints.get(5).y,joints.get(7).x,joints.get(7).y); // Left foot\n h.line(joints.get(6).x,joints.get(6).y,joints.get(8).x,joints.get(8).y); // Right foot\n h.line(joints.get(1).x,joints.get(1).y,joints.get(9).x,joints.get(9).y); // Left upper arm\n h.line(joints.get(1).x,joints.get(1).y,joints.get(10).x,joints.get(10).y); // Right upper arm\n h.line(joints.get(9).x,joints.get(9).y,joints.get(11).x,joints.get(11).y); // Left lower arm\n h.line(joints.get(10).x,joints.get(10).y,joints.get(12).x,joints.get(12).y); // Right lower arm\n h.line(joints.get(11).x,joints.get(11).y,joints.get(13).x,joints.get(13).y); // Left hand\n h.line(joints.get(12).x,joints.get(12).y,joints.get(14).x,joints.get(14).y); // Right hand\n}\n\nvoid mousePressed()\n{\n // Find nearest joint to mouse position.\n float minDist = MAX_FLOAT;\n for (int i=0; i=0)\n {\n joints.get(movingJoint).x = mouseX;\n joints.get(movingJoint).y = mouseY;\n }\n}" }, { "path": "Handy/reference/allclasses-frame.html", "content": "\n\n\n\n\nAll Classes\n\n\n\n\n\n

All Classes

\n
\n\n
\n\n\n" }, { "path": "Handy/reference/allclasses-noframe.html", "content": "\n\n\n\n\nAll Classes\n\n\n\n\n\n

All Classes

\n
\n\n
\n\n\n" }, { "path": "Handy/reference/constant-values.html", "content": "\n\n\n\n\nConstant Field Values\n\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n
\n

Constant Field Values

\n

Contents

\n
\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n\n\n" }, { "path": "Handy/reference/deprecated-list.html", "content": "\n\n\n\n\nDeprecated List\n\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n
\n

Deprecated API

\n

Contents

\n
\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n\n\n" }, { "path": "Handy/reference/help-doc.html", "content": "\n\n\n\n\nAPI Help\n\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n
\n

How This API Document Is Organized

\n
This API (Application Programming Interface) document has pages corresponding to the items in the navigation bar, described as follows.
\n
\n
\n
    \n
  • \n

    Package

    \n

    Each package has a page that contains a list of its classes and interfaces, with a summary for each. This page can contain six categories:

    \n
      \n
    • Interfaces (italic)
      • \n
    • Classes
      • \n
    • Enums
      • \n
    • Exceptions
      • \n
    • Errors
      • \n
    • Annotation Types
      • \n
    \n
    • \n
  • \n

    Class/Interface

    \n

    Each class, interface, nested class and nested interface has its own separate page. Each of these pages has three sections consisting of a class/interface description, summary tables, and detailed member descriptions:

    \n
      \n
    • Class inheritance diagram
      • \n
    • Direct Subclasses
      • \n
    • All Known Subinterfaces
      • \n
    • All Known Implementing Classes
      • \n
    • Class/interface declaration
      • \n
    • Class/interface description
      • \n
    \n
      \n
    • Nested Class Summary
      • \n
    • Field Summary
      • \n
    • Constructor Summary
      • \n
    • Method Summary
      • \n
    \n
      \n
    • Field Detail
      • \n
    • Constructor Detail
      • \n
    • Method Detail
      • \n
    \n

    Each summary entry contains the first sentence from the detailed description for that item. The summary entries are alphabetical, while the detailed descriptions are in the order they appear in the source code. This preserves the logical groupings established by the programmer.

    \n
    • \n
  • \n

    Annotation Type

    \n

    Each annotation type has its own separate page with the following sections:

    \n
      \n
    • Annotation Type declaration
      • \n
    • Annotation Type description
      • \n
    • Required Element Summary
      • \n
    • Optional Element Summary
      • \n
    • Element Detail
      • \n
    \n
    • \n
  • \n

    Enum

    \n

    Each enum has its own separate page with the following sections:

    \n
      \n
    • Enum declaration
      • \n
    • Enum description
      • \n
    • Enum Constant Summary
      • \n
    • Enum Constant Detail
      • \n
    \n
    • \n
  • \n

    Use

    \n

    Each documented package, class and interface has its own Use page. This page describes what packages, classes, methods, constructors and fields use any part of the given class or package. Given a class or interface A, its Use page includes subclasses of A, fields declared as A, methods that return A, and methods and constructors with parameters of type A. You can access this page by first going to the package, class or interface, then clicking on the \"Use\" link in the navigation bar.

    \n
    • \n
  • \n

    Tree (Class Hierarchy)

    \n

    There is a Class Hierarchy page for all packages, plus a hierarchy for each package. Each hierarchy page contains a list of classes and a list of interfaces. The classes are organized by inheritance structure starting with java.lang.Object. The interfaces do not inherit from java.lang.Object.

    \n
      \n
    • When viewing the Overview page, clicking on \"Tree\" displays the hierarchy for all packages.
      • \n
    • When viewing a particular package, class or interface page, clicking \"Tree\" displays the hierarchy for only that package.
      • \n
    \n
    • \n
  • \n

    Deprecated API

    \n

    The Deprecated API page lists all of the API that have been deprecated. A deprecated API is not recommended for use, generally due to improvements, and a replacement API is usually given. Deprecated APIs may be removed in future implementations.

    \n
    • \n
  • \n

    Index

    \n

    The Index contains an alphabetic list of all classes, interfaces, constructors, methods, and fields.

    \n
    • \n
  • \n

    Prev/Next

    \n

    These links take you to the next or previous class, interface, package, or related page.

    \n
    • \n
  • \n

    Frames/No Frames

    \n

    These links show and hide the HTML frames. All pages are available with or without frames.

    \n
    • \n
  • \n

    All Classes

    \n

    The All Classes link shows all classes and interfaces except non-static nested types.

    \n
    • \n
  • \n

    Serialized Form

    \n

    Each serializable or externalizable class has a description of its serialization fields and methods. This information is of interest to re-implementors, not to developers using the API. While there is no link in the navigation bar, you can get to this information by going to any serialized class and clicking \"Serialized Form\" in the \"See also\" section of the class description.

    \n
    • \n
  • \n

    Constant Field Values

    \n

    The Constant Field Values page lists the static final fields and their values.

    \n
    • \n
\nThis help file applies to API documentation generated using the standard doclet.
\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n\n\n" }, { "path": "Handy/reference/index-files/index-1.html", "content": "\n\n\n\n\nA-Index\n\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n\n\n\n
\n\n
\n\n\n
\n\n
A B C D E F G H I L O P Q R S T V \n\n\n

A

\n
\n
ambientLight(float, float, float) - Method in class org.gicentre.handy.HandyRecorder
\n
\n
Would set a ambient light source for this graphics context but ignores it in this case as this will\n be handled by the parent sketch.
\n
\n
ambientLight(float, float, float, float, float, float) - Method in class org.gicentre.handy.HandyRecorder
\n
\n
Would set a ambient light source for this graphics context but ignores it in this case as this will\n be handled by the parent sketch.
\n
\n
arc(float, float, float, float, float, float) - Method in class org.gicentre.handy.HandyRecorder
\n
\n
Draws an arc along the outer edge of an ellipse defined by the x,y, w and h parameters.
\n
\n
arc(float, float, float, float, float, float) - Method in class org.gicentre.handy.HandyRenderer
\n
\n
Draws an arc along the outer edge of an ellipse defined by the x,y, w and h parameters.
\n
\n
\nA B C D E F G H I L O P Q R S T V 
\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n\n\n\n
\n\n
\n\n\n
\n\n\n\n" }, { "path": "Handy/reference/index-files/index-10.html", "content": "\n\n\n\n\nL-Index\n\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n\n\n\n
\n\n
\n\n\n
\n\n
A B C D E F G H I L O P Q R S T V \n\n\n

L

\n
\n
lightFalloff(float, float, float) - Method in class org.gicentre.handy.HandyRecorder
\n
\n
Would set a light falloff for point, spot and ambient light sources for this graphics context but ignores \n it in this case as this will be handled by the parent sketch.
\n
\n
lights() - Method in class org.gicentre.handy.HandyRecorder
\n
\n
Would set the default 3d lighting for this graphics context but ignores it in this case as this will\n be handled by the parent sketch.
\n
\n
lightSpecular(float, float, float) - Method in class org.gicentre.handy.HandyRecorder
\n
\n
Would set a specular colour for light sources in this graphics context but ignores \n it in this case as this will be handled by the parent sketch.
\n
\n
line(float, float, float, float) - Method in class org.gicentre.handy.HandyRecorder
\n
\n
Draws a 2D line between the given coordinate pairs.
\n
\n
line(float, float, float, float, float, float) - Method in class org.gicentre.handy.HandyRecorder
\n
\n
Draws a 3D line between the given coordinate triplets.
\n
\n
line(float, float, float, float) - Method in class org.gicentre.handy.HandyRenderer
\n
\n
Draws a 2D line between the given coordinate pairs.
\n
\n
line(float, float, float, float, float, float) - Method in class org.gicentre.handy.HandyRenderer
\n
\n
Draws a 3D line between the given coordinate triplets.
\n
\n
\nA B C D E F G H I L O P Q R S T V 
\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n\n\n\n
\n\n
\n\n\n
\n\n\n\n" }, { "path": "Handy/reference/index-files/index-11.html", "content": "\n\n\n\n\nO-Index\n\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n\n\n\n
\n\n
\n\n\n
\n\n
A B C D E F G H I L O P Q R S T V \n\n\n

O

\n
\n
org.gicentre.handy - package org.gicentre.handy
\n
\n
Main package for creating a handy renderer\n\n
\n
\n
\nA B C D E F G H I L O P Q R S T V 
\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n\n\n\n
\n\n
\n\n\n
\n\n\n\n" }, { "path": "Handy/reference/index-files/index-12.html", "content": "\n\n\n\n\nP-Index\n\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n\n\n\n
\n\n
\n\n\n
\n\n
A B C D E F G H I L O P Q R S T V \n\n\n

P

\n
\n
perspective() - Method in class org.gicentre.handy.HandyRecorder
\n
\n
Would apply the default perspective settings but ignored here as this will be handled by the parent sketch.
\n
\n
perspective(float, float, float, float) - Method in class org.gicentre.handy.HandyRecorder
\n
\n
Would allow perspective settings to be changed but ignored here as this will be handled by the parent sketch.
\n
\n
point(float, float) - Method in class org.gicentre.handy.HandyRecorder
\n
\n
Draws 2D point at the given location.
\n
\n
point(float, float, float) - Method in class org.gicentre.handy.HandyRecorder
\n
\n
Draws 3D point at the given location.
\n
\n
point(float, float) - Method in class org.gicentre.handy.HandyRenderer
\n
\n
Draws 2D point at the given location.
\n
\n
point(float, float, float) - Method in class org.gicentre.handy.HandyRenderer
\n
\n
Draws 3D point at the given location.
\n
\n
pointLight(float, float, float, float, float, float) - Method in class org.gicentre.handy.HandyRecorder
\n
\n
Would set a point light source for this graphics context but ignores it in this case as this will\n be handled by the parent sketch.
\n
\n
polyLine(float[], float[]) - Method in class org.gicentre.handy.HandyRenderer
\n
\n
Draws a complex line that links the given coordinates.
\n
\n
popMatrix() - Method in class org.gicentre.handy.HandyRecorder
\n
\n
Would retrieve a copy of the current transform matrix from the stack but ignored here as this\n will be handled by the parent sketch.
\n
\n
printMatrix() - Method in class org.gicentre.handy.HandyRecorder
\n
\n
Would print the current transform matrix but ignored here as this will be handled by the parent sketch.
\n
\n
pushMatrix() - Method in class org.gicentre.handy.HandyRecorder
\n
\n
Would store a copy of the current transform matrix on the stack but ignored here as this\n will be handled by the parent sketch.
\n
\n
\nA B C D E F G H I L O P Q R S T V 
\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n\n\n\n
\n\n
\n\n\n
\n\n\n\n" }, { "path": "Handy/reference/index-files/index-13.html", "content": "\n\n\n\n\nQ-Index\n\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n\n\n\n
\n\n
\n\n\n
\n\n
A B C D E F G H I L O P Q R S T V \n\n\n

Q

\n
\n
quad(float, float, float, float, float, float, float, float) - Method in class org.gicentre.handy.HandyRecorder
\n
\n
Draws a quadrilateral shape.
\n
\n
quad(float, float, float, float, float, float, float, float) - Method in class org.gicentre.handy.HandyRenderer
\n
\n
Draws a quadrilateral shape.
\n
\n
\nA B C D E F G H I L O P Q R S T V 
\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n\n\n\n
\n\n
\n\n\n
\n\n\n\n" }, { "path": "Handy/reference/index-files/index-14.html", "content": "\n\n\n\n\nR-Index\n\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n\n\n\n
\n\n
\n\n\n
\n\n
A B C D E F G H I L O P Q R S T V \n\n\n

R

\n
\n
rect(float, float, float, float) - Method in class org.gicentre.handy.HandyRecorder
\n
\n
Draws a rectangle using the given location and dimensions.
\n
\n
rect(float, float, float, float) - Method in class org.gicentre.handy.HandyRenderer
\n
\n
Draws a rectangle using the given location and dimensions.
\n
\n
resetMatrix() - Method in class org.gicentre.handy.HandyRecorder
\n
\n
Would reset the current transform matrix to its default transform but ignored here as this\n will be handled by the parent sketch.
\n
\n
resetStyles() - Method in class org.gicentre.handy.HandyRenderer
\n
\n
Resets the sketchy styles to default values.
\n
\n
rotate(float) - Method in class org.gicentre.handy.HandyRecorder
\n
\n
Would rotate the coordinate system by the given angle but ignored here as this will be\n handled by the parent sketch.
\n
\n
rotate(float, float, float, float) - Method in class org.gicentre.handy.HandyRecorder
\n
\n
Would rotate the coordinate system by the given angles but ignored here as this will be\n handled by the parent sketch.
\n
\n
rotateX(float) - Method in class org.gicentre.handy.HandyRecorder
\n
\n
Would rotate the coordinate system around the x-axis in 3d space but ignored here as this\n will be handled by the parent sketch.
\n
\n
rotateY(float) - Method in class org.gicentre.handy.HandyRecorder
\n
\n
Would rotate the coordinate system around the y-axis in 3d space but ignored here as this\n will be handled by the parent sketch.
\n
\n
rotateZ(float) - Method in class org.gicentre.handy.HandyRecorder
\n
\n
Would rotate the coordinate system around the z-axis in 3d space but ignored here as this\n will be handled by the parent sketch.
\n
\n
\nA B C D E F G H I L O P Q R S T V 
\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n\n\n\n
\n\n
\n\n\n
\n\n\n\n" }, { "path": "Handy/reference/index-files/index-15.html", "content": "\n\n\n\n\nS-Index\n\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n\n\n\n
\n\n
\n\n\n
\n\n
A B C D E F G H I L O P Q R S T V \n\n\n

S

\n
\n
scale(float) - Method in class org.gicentre.handy.HandyRecorder
\n
\n
Would scale the coordinate system in all directions but ignored here as this will be handled\n by the parent sketch.
\n
\n
scale(float, float) - Method in class org.gicentre.handy.HandyRecorder
\n
\n
Would scale the coordinate system by the given x and y values but ignored here as this will be\n handled by the parent sketch.
\n
\n
scale(float, float, float) - Method in class org.gicentre.handy.HandyRecorder
\n
\n
Would scale the coordinate system by the given x, y and z values but ignored here as this will be\n handled by the parent sketch.
\n
\n
setBackgroundColour(int) - Method in class org.gicentre.handy.HandyRenderer
\n
\n
Sets the background colour for closed shapes.
\n
\n
setBowing(float) - Method in class org.gicentre.handy.HandyRenderer
\n
\n
Sets the amount of 'bowing' of lines (contols the degree to which a straigh line appears as an 'I' or 'C').
\n
\n
setFillColour(int) - Method in class org.gicentre.handy.HandyRenderer
\n
\n
Sets the fill colour for closed shapes.
\n
\n
setFillGap(float) - Method in class org.gicentre.handy.HandyRenderer
\n
\n
Determines the gap between fill lines.
\n
\n
setFillWeight(float) - Method in class org.gicentre.handy.HandyRenderer
\n
\n
Determines the thickness of fill lines.
\n
\n
setGraphics(PGraphics) - Method in class org.gicentre.handy.HandyRenderer
\n
\n
Sets the graphics context into which all output is directed.
\n
\n
setHachureAngle(float) - Method in class org.gicentre.handy.HandyRenderer
\n
\n
Sets the angle for shading hachures.
\n
\n
setHachurePerturbationAngle(float) - Method in class org.gicentre.handy.HandyRenderer
\n
\n
Sets the maximum random perturbation in hachure angle per object.
\n
\n
setIsAlternating(boolean) - Method in class org.gicentre.handy.HandyRenderer
\n
\n
Determines whether or not an alternating fill stroke is used to shade shapes.
\n
\n
setIsHandy(boolean) - Method in class org.gicentre.handy.HandyRenderer
\n
\n
Determines whether or not the renderer applies a hand-drawn sketchy appearance.
\n
\n
setOverrideFillColour(boolean) - Method in class org.gicentre.handy.HandyRenderer
\n
\n
Determines whether or not to override the fill colour that would otherwise be determined by\n the sketch's fillColor setting.
\n
\n
setOverrideStrokeColour(boolean) - Method in class org.gicentre.handy.HandyRenderer
\n
\n
Determines whether or not to override the stroke colour that would otherwise be determined by\n the sketch's strokeColor setting.
\n
\n
setRoughness(float) - Method in class org.gicentre.handy.HandyRenderer
\n
\n
Sets the general roughness of the sketch.
\n
\n
setSecondaryColour(int) - Method in class org.gicentre.handy.HandyRenderer
\n
\n
Sets the secondary colour for line filling.
\n
\n
setSeed(long) - Method in class org.gicentre.handy.HandyRenderer
\n
\n
Sets the seed used for random offsets when drawing.
\n
\n
setStrokeColour(int) - Method in class org.gicentre.handy.HandyRenderer
\n
\n
Sets the stroke colour for rendering features.
\n
\n
setStrokeWeight(float) - Method in class org.gicentre.handy.HandyRenderer
\n
\n
Determines the thickness of outer lines.
\n
\n
setUseSecondaryColour(boolean) - Method in class org.gicentre.handy.HandyRenderer
\n
\n
Determines whether or not a secondary colour is used for filling lines.
\n
\n
shape(float[], float[]) - Method in class org.gicentre.handy.HandyRenderer
\n
\n
Draws a closed 2d polygon based on the given arrays of vertices.
\n
\n
shape(float[], float[], float[]) - Method in class org.gicentre.handy.HandyRenderer
\n
\n
Draws a closed 3d polygon based on the given arrays of vertices.
\n
\n
shape(float[], float[], boolean) - Method in class org.gicentre.handy.HandyRenderer
\n
\n
Draws a 2d polygon based on the given arrays of vertices.
\n
\n
shape(float[], float[], float[], boolean) - Method in class org.gicentre.handy.HandyRenderer
\n
\n
Draws a 3d polygon based on the given arrays of vertices.
\n
\n
Simplifier - Class in org.gicentre.handy
\n
\n
Performs Douglas-Peucker simplification on linear coordinate collections.
\n
\n
Simplifier() - Constructor for class org.gicentre.handy.Simplifier
\n
 
\n
simplify(ArrayList<PVector>, float) - Static method in class org.gicentre.handy.Simplifier
\n
\n
Creates a simplified version of the given collection of coordinates.
\n
\n
spotLight(float, float, float, float, float, float, float, float, float, float, float) - Method in class org.gicentre.handy.HandyRecorder
\n
\n
Would set a spotlight source for this graphics context but ignores it in this case as this will\n be handled by the parent sketch.
\n
\n
\nA B C D E F G H I L O P Q R S T V 
\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n\n\n\n
\n\n
\n\n\n
\n\n\n\n" }, { "path": "Handy/reference/index-files/index-16.html", "content": "\n\n\n\n\nT-Index\n\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n\n\n\n
\n\n
\n\n\n
\n\n
A B C D E F G H I L O P Q R S T V \n\n\n

T

\n
\n
toArray(List<Float>) - Static method in class org.gicentre.handy.HandyRenderer
\n
\n
Converts an array list of numeric values into a floating point array.
\n
\n
translate(float, float) - Method in class org.gicentre.handy.HandyRecorder
\n
\n
Would translate the coordinate system by the given x and y values but ignored here as this will\n be handled by the parent sketch.
\n
\n
translate(float, float, float) - Method in class org.gicentre.handy.HandyRecorder
\n
\n
Would translate the coordinate system by the given x and y values but ignored here as this \n will be handled by the parent sketch.
\n
\n
triangle(float, float, float, float, float, float) - Method in class org.gicentre.handy.HandyRecorder
\n
\n
Draws a triangle through the three pairs of coordinates.
\n
\n
triangle(float, float, float, float, float, float) - Method in class org.gicentre.handy.HandyRenderer
\n
\n
Draws a triangle through the three pairs of coordinates.
\n
\n
\nA B C D E F G H I L O P Q R S T V 
\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n\n\n\n
\n\n
\n\n\n
\n\n\n\n" }, { "path": "Handy/reference/index-files/index-17.html", "content": "\n\n\n\n\nV-Index\n\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n\n\n\n
\n\n
\n\n\n
\n\n
A B C D E F G H I L O P Q R S T V \n\n\n

V

\n
\n
Version - Class in org.gicentre.handy
\n
\n
Stores version information about the Handy sketchy drawing package.
\n
\n
Version() - Constructor for class org.gicentre.handy.Version
\n
 
\n
vertex(float, float) - Method in class org.gicentre.handy.HandyRecorder
\n
\n
Adds a 2d vertex to a shape that was started with a call to beginShape() \n or one of its variants.
\n
\n
vertex(float, float, float) - Method in class org.gicentre.handy.HandyRecorder
\n
\n
Adds a 3d vertex to a shape that was started with a call to beginShape() \n or one of its variants.
\n
\n
vertex(float, float) - Method in class org.gicentre.handy.HandyRenderer
\n
\n
Adds a 2d vertex to a shape that was started with a call to beginShape() \n or one of its variants.
\n
\n
vertex(float, float, float) - Method in class org.gicentre.handy.HandyRenderer
\n
\n
Adds a 3d vertex to a shape that was started with a call to beginShape() \n or one of its variants.
\n
\n
\nA B C D E F G H I L O P Q R S T V 
\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n\n\n\n
\n\n
\n\n\n
\n\n\n\n" }, { "path": "Handy/reference/index-files/index-2.html", "content": "\n\n\n\n\nB-Index\n\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n\n\n\n
\n\n
\n\n\n
\n\n
A B C D E F G H I L O P Q R S T V \n\n\n

B

\n
\n
beginCamera() - Method in class org.gicentre.handy.HandyRecorder
\n
\n
Would start 3d camera position definition but ignored here as this will be handled by the parent sketch.
\n
\n
beginShape() - Method in class org.gicentre.handy.HandyRecorder
\n
\n
Starts a new shape of type POLYGON.
\n
\n
beginShape(int) - Method in class org.gicentre.handy.HandyRecorder
\n
\n
Starts a new shape of the type specified in the mode parameter.
\n
\n
beginShape() - Method in class org.gicentre.handy.HandyRenderer
\n
\n
Starts a new shape of type POLYGON.
\n
\n
beginShape(int) - Method in class org.gicentre.handy.HandyRenderer
\n
\n
Starts a new shape of the type specified in the mode parameter.
\n
\n
blendMode(int) - Method in class org.gicentre.handy.HandyRecorder
\n
\n
Would set the blend mode for this graphics context but ignores it in this case as this will\n be handled by the parent sketch.
\n
\n
box(float) - Method in class org.gicentre.handy.HandyRecorder
\n
\n
Draws 3D cube with the given unit dimension.
\n
\n
box(float, float, float) - Method in class org.gicentre.handy.HandyRecorder
\n
\n
Draws 3D box with the given dimensions.
\n
\n
box(float) - Method in class org.gicentre.handy.HandyRenderer
\n
\n
Draws 3D cube with the given unit dimension.
\n
\n
box(float, float, float) - Method in class org.gicentre.handy.HandyRenderer
\n
\n
Draws 3D box with the given dimensions.
\n
\n
\nA B C D E F G H I L O P Q R S T V 
\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n\n\n\n
\n\n
\n\n\n
\n\n\n\n" }, { "path": "Handy/reference/index-files/index-3.html", "content": "\n\n\n\n\nC-Index\n\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n\n\n\n
\n\n
\n\n\n
\n\n
A B C D E F G H I L O P Q R S T V \n\n\n

C

\n
\n
camera() - Method in class org.gicentre.handy.HandyRecorder
\n
\n
Would allow the default 3d camera position to be set but ignored here as this will be handled by the parent sketch.
\n
\n
copyGraphics(PGraphics, PGraphics) - Static method in class org.gicentre.handy.HandyRenderer
\n
\n
Copies the settings from one graphics context to another.
\n
\n
createColouredPencil(PApplet) - Static method in class org.gicentre.handy.HandyPresets
\n
\n
Creates a renderer that draws in a coloured pencil sketch style.
\n
\n
createMarker(PApplet) - Static method in class org.gicentre.handy.HandyPresets
\n
\n
Creates a renderer that draws in a felt-tip marker ('Sharpie') style.
\n
\n
createPencil(PApplet) - Static method in class org.gicentre.handy.HandyPresets
\n
\n
Creates a renderer that draws in a pencil sketch style.
\n
\n
createWaterAndInk(PApplet) - Static method in class org.gicentre.handy.HandyPresets
\n
\n
Creates a renderer that draws in a watercolour and ink style.
\n
\n
curveVertex(float, float) - Method in class org.gicentre.handy.HandyRecorder
\n
\n
Adds a 2d vertex to a shape or line that has curved edges.
\n
\n
curveVertex(float, float, float) - Method in class org.gicentre.handy.HandyRecorder
\n
\n
Adds a 3d vertex to a shape or line that has curved edges.
\n
\n
curveVertex(float, float) - Method in class org.gicentre.handy.HandyRenderer
\n
\n
Adds a 2d vertex to a shape or line that has curved edges.
\n
\n
curveVertex(float, float, float) - Method in class org.gicentre.handy.HandyRenderer
\n
\n
Adds a 3d vertex to a shape or line that has curved edges.
\n
\n
\nA B C D E F G H I L O P Q R S T V 
\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n\n\n\n
\n\n
\n\n\n
\n\n\n\n" }, { "path": "Handy/reference/index-files/index-4.html", "content": "\n\n\n\n\nD-Index\n\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n\n\n\n
\n\n
\n\n\n
\n\n
A B C D E F G H I L O P Q R S T V \n\n\n

D

\n
\n
directionalLight(float, float, float, float, float, float) - Method in class org.gicentre.handy.HandyRecorder
\n
\n
Would set a directional light source for this graphics context but ignores it in this case as this will\n be handled by the parent sketch.
\n
\n
\nA B C D E F G H I L O P Q R S T V 
\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n\n\n\n
\n\n
\n\n\n
\n\n\n\n" }, { "path": "Handy/reference/index-files/index-5.html", "content": "\n\n\n\n\nE-Index\n\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n\n\n\n
\n\n
\n\n\n
\n\n
A B C D E F G H I L O P Q R S T V \n\n\n

E

\n
\n
ellipse(float, float, float, float) - Method in class org.gicentre.handy.HandyRecorder
\n
\n
Draws an ellipse using the given location and dimensions.
\n
\n
ellipse(float, float, float, float) - Method in class org.gicentre.handy.HandyRenderer
\n
\n
Draws an ellipse using the given location and dimensions.
\n
\n
endCamera() - Method in class org.gicentre.handy.HandyRecorder
\n
\n
Would end 3d camera position definition but ignored here as this will be handled by the parent sketch.
\n
\n
endShape() - Method in class org.gicentre.handy.HandyRecorder
\n
\n
Ends a shape definition.
\n
\n
endShape(int) - Method in class org.gicentre.handy.HandyRecorder
\n
\n
Ends a shape definition.
\n
\n
endShape() - Method in class org.gicentre.handy.HandyRenderer
\n
\n
Ends a shape definition.
\n
\n
endShape(int) - Method in class org.gicentre.handy.HandyRenderer
\n
\n
Ends a shape definition.
\n
\n
\nA B C D E F G H I L O P Q R S T V 
\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n\n\n\n
\n\n
\n\n\n
\n\n\n\n" }, { "path": "Handy/reference/index-files/index-6.html", "content": "\n\n\n\n\nF-Index\n\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n\n\n\n
\n\n
\n\n\n
\n\n
A B C D E F G H I L O P Q R S T V \n\n\n

F

\n
\n
frustum(float, float, float, float, float, float) - Method in class org.gicentre.handy.HandyRecorder
\n
\n
Would allow the view frustum (clipping object) to be set but ignored here as this will be handled by the parent sketch.
\n
\n
\nA B C D E F G H I L O P Q R S T V 
\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n\n\n\n
\n\n
\n\n\n
\n\n\n\n" }, { "path": "Handy/reference/index-files/index-7.html", "content": "\n\n\n\n\nG-Index\n\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n\n\n\n
\n\n
\n\n\n
\n\n
A B C D E F G H I L O P Q R S T V \n\n\n

G

\n
\n
getSimplifiedX() - Static method in class org.gicentre.handy.Simplifier
\n
\n
Provides the simplified x coordinates.
\n
\n
getSimplifiedY() - Static method in class org.gicentre.handy.Simplifier
\n
\n
Provides the simplified y coordinates.
\n
\n
getText() - Static method in class org.gicentre.handy.Version
\n
\n
Reports the current version of the handy package.
\n
\n
getVersion() - Static method in class org.gicentre.handy.Version
\n
\n
Reports the numeric version of the handy package.
\n
\n
\nA B C D E F G H I L O P Q R S T V 
\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n\n\n\n
\n\n
\n\n\n
\n\n\n\n" }, { "path": "Handy/reference/index-files/index-8.html", "content": "\n\n\n\n\nH-Index\n\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n\n\n\n
\n\n
\n\n\n
\n\n
A B C D E F G H I L O P Q R S T V \n\n\n

H

\n
\n
HandyPresets - Class in org.gicentre.handy
\n
\n
Set of static classes for creating preset handy styles, such as pencil sketch, ink and\n watercolour, 'Sharpie' style etc.
\n
\n
HandyRecorder - Class in org.gicentre.handy
\n
\n
A PGraphics class for rendering in a sketchy style.
\n
\n
HandyRecorder(PApplet) - Constructor for class org.gicentre.handy.HandyRecorder
\n
\n
Creates a new sketchy graphics context associated with the given parent sketch.
\n
\n
HandyRecorder(HandyRenderer) - Constructor for class org.gicentre.handy.HandyRecorder
\n
\n
Creates a new sketchy graphics context associated with the given handy renderer.
\n
\n
HandyRenderer - Class in org.gicentre.handy
\n
\n
The renderer that draws graphic primitives in a sketchy style.
\n
\n
HandyRenderer(PApplet) - Constructor for class org.gicentre.handy.HandyRenderer
\n
\n
Creates a new HandyRender capable of using standard Processing drawing commands\n to render features in a sketchy hand-drawn style.
\n
\n
\nA B C D E F G H I L O P Q R S T V 
\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n\n\n\n
\n\n
\n\n\n
\n\n\n\n" }, { "path": "Handy/reference/index-files/index-9.html", "content": "\n\n\n\n\nI-Index\n\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n\n\n\n
\n\n
\n\n\n
\n\n
A B C D E F G H I L O P Q R S T V \n\n\n

I

\n
\n
isHandy() - Method in class org.gicentre.handy.HandyRenderer
\n
\n
Reports whether the renderer is currently set to draw in a sketchy style or not.
\n
\n
\nA B C D E F G H I L O P Q R S T V 
\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n\n\n\n
\n\n
\n\n\n
\n\n\n\n" }, { "path": "Handy/reference/index.html", "content": "\n\n\n\n\nGenerated Documentation (Untitled)\n\n\n\n\n\n\n<noscript>\n<div>JavaScript is disabled on your browser.</div>\n</noscript>\n<h2>Frame Alert</h2>\n<p>This document is designed to be viewed using the frames feature. If you see this message, you are using a non-frame-capable web client. Link to <a href=\"org/gicentre/handy/package-summary.html\">Non-frame version</a>.</p>\n\n\n\n" }, { "path": "Handy/reference/org/gicentre/handy/HandyPresets.html", "content": "\n\n\n\n\nHandyPresets\n\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n\n\n\n
\n\n
\n
\n
    \n
  • Summary: 
    • \n
  • Nested | 
    • \n
  • Field | 
    • \n
  • Constr | 
    • \n
  • Method
    • \n
\n
    \n
  • Detail: 
    • \n
  • Field | 
    • \n
  • Constr | 
    • \n
  • Method
    • \n
\n
\n\n\n
\n\n\n
\n
org.gicentre.handy
\n

Class HandyPresets

\n
\n
\n
    \n
  • java.lang.Object
    • \n
  • \n
      \n
    • org.gicentre.handy.HandyPresets
      • \n
    \n
    • \n
\n
\n
    \n
  • \n
    \n
    \n
    public class HandyPresets\nextends java.lang.Object
    \n
    Set of static classes for creating preset handy styles, such as pencil sketch, ink and\n watercolour, 'Sharpie' style etc.
    \n
    \n
    Version:
    \n
    1.0, 23rd January, 2012.
    \n
    Author:
    \n
    Jo Wood, giCentre, City University London.
    \n
    \n
    • \n
\n
\n
\n
    \n
  • \n\n
      \n
    • \n\n\n

      Method Summary

      \n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
      All Methods Static Methods Concrete Methods 
      Modifier and TypeMethod and Description
      static HandyRenderercreateColouredPencil(processing.core.PApplet parent)\n
      Creates a renderer that draws in a coloured pencil sketch style.
      \n
      static HandyRenderercreateMarker(processing.core.PApplet parent)\n
      Creates a renderer that draws in a felt-tip marker ('Sharpie') style.
      \n
      static HandyRenderercreatePencil(processing.core.PApplet parent)\n
      Creates a renderer that draws in a pencil sketch style.
      \n
      static HandyRenderercreateWaterAndInk(processing.core.PApplet parent)\n
      Creates a renderer that draws in a watercolour and ink style.
      \n
      \n
        \n
      • \n\n\n

        Methods inherited from class java.lang.Object

        \nclone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
        • \n
      \n
      • \n
    \n
    • \n
\n
\n
\n
    \n
  • \n\n
      \n
    • \n\n\n

      Method Detail

      \n\n\n\n
        \n
      • \n

        createPencil

        \n
        public static HandyRenderer createPencil(processing.core.PApplet parent)
        \n
        Creates a renderer that draws in a pencil sketch style.
        \n
        \n
        Parameters:
        \n
        parent - PArent sketch that will do the drawing.
        \n
        Returns:
        \n
        Renderer that draws in a pencil sketch style.
        \n
        \n
        • \n
      \n\n\n\n
        \n
      • \n

        createColouredPencil

        \n
        public static HandyRenderer createColouredPencil(processing.core.PApplet parent)
        \n
        Creates a renderer that draws in a coloured pencil sketch style.
        \n
        \n
        Parameters:
        \n
        parent - PArent sketch that will do the drawing.
        \n
        Returns:
        \n
        Renderer that draws in a coloured pencil sketch style.
        \n
        \n
        • \n
      \n\n\n\n
        \n
      • \n

        createWaterAndInk

        \n
        public static HandyRenderer createWaterAndInk(processing.core.PApplet parent)
        \n
        Creates a renderer that draws in a watercolour and ink style.
        \n
        \n
        Parameters:
        \n
        parent - PArent sketch that will do the drawing.
        \n
        Returns:
        \n
        Renderer that draws in a pencil sketch style.
        \n
        \n
        • \n
      \n\n\n\n
        \n
      • \n

        createMarker

        \n
        public static HandyRenderer createMarker(processing.core.PApplet parent)
        \n
        Creates a renderer that draws in a felt-tip marker ('Sharpie') style.
        \n
        \n
        Parameters:
        \n
        parent - PArent sketch that will do the drawing.
        \n
        Returns:
        \n
        Renderer that draws in a marker style.
        \n
        \n
        • \n
      \n
      • \n
    \n
    • \n
\n
\n
\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n\n\n\n
\n\n
\n
\n
    \n
  • Summary: 
    • \n
  • Nested | 
    • \n
  • Field | 
    • \n
  • Constr | 
    • \n
  • Method
    • \n
\n
    \n
  • Detail: 
    • \n
  • Field | 
    • \n
  • Constr | 
    • \n
  • Method
    • \n
\n
\n\n\n
\n\n\n\n" }, { "path": "Handy/reference/org/gicentre/handy/HandyRecorder.html", "content": "\n\n\n\n\nHandyRecorder\n\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n\n\n\n
\n\n
\n
\n\n\n
\n\n\n
\n\n\n
\n
org.gicentre.handy
\n

Class HandyRecorder

\n
\n
\n
    \n
  • java.lang.Object
    • \n
  • \n
      \n
    • processing.core.PImage
      • \n
    • \n
        \n
      • processing.core.PGraphics
        • \n
      • \n
          \n
        • org.gicentre.handy.HandyRecorder
          • \n
        \n
        • \n
      \n
      • \n
    \n
    • \n
\n
\n
    \n
  • \n
    \n
    All Implemented Interfaces:
    \n
    java.lang.Cloneable, processing.core.PConstants
    \n
    \n
    \n
    \n
    public class HandyRecorder\nextends processing.core.PGraphics
    \n
    A PGraphics class for rendering in a sketchy style. An object of this type can be passed\n to a sketch's beginRecord(PGraphics) method.
    \n
    \n
    Version:
    \n
    2.0, 3rd April, 2016.
    \n
    Author:
    \n
    Jo Wood, giCentre, City University London.
    \n
    \n
    • \n
\n
\n
\n
    \n
  • \n\n
      \n
    • \n\n\n

      Nested Class Summary

      \n
        \n
      • \n\n\n

        Nested classes/interfaces inherited from class processing.core.PGraphics

        \nprocessing.core.PGraphics.AsyncImageSaver
        • \n
      \n
      • \n
    \n\n
      \n
    • \n\n\n

      Field Summary

      \n
        \n
      • \n\n\n

        Fields inherited from class processing.core.PGraphics

        \nA, AB, AG, ambientB, ambientColor, ambientG, ambientR, AR, asyncImageSaver, autoNormal, B, backgroundA, backgroundAi, backgroundAlpha, backgroundB, backgroundBi, backgroundColor, backgroundG, backgroundGi, backgroundR, backgroundRi, BEEN_LIT, bezierBasisInverse, bezierBasisMatrix, bezierDetail, bezierDrawMatrix, bezierInited, blendMode, cacheMap, calcA, calcAi, calcAlpha, calcB, calcBi, calcColor, calcG, calcGi, calcR, calcRi, colorMode, colorModeA, colorModeX, colorModeY, colorModeZ, cosLUT, curveBasisMatrix, curveDetail, curveDrawMatrix, curveInited, curveTightness, curveToBezierMatrix, curveVertexCount, curveVertices, DA, DB, DEFAULT_STROKE_CAP, DEFAULT_STROKE_JOIN, DEFAULT_STROKE_WEIGHT, DEFAULT_VERTICES, DG, DR, EB, edge, EDGE, EG, ellipseMode, emissiveB, emissiveColor, emissiveG, emissiveR, ER, ERROR_BACKGROUND_IMAGE_FORMAT, ERROR_BACKGROUND_IMAGE_SIZE, ERROR_PUSHMATRIX_OVERFLOW, ERROR_PUSHMATRIX_UNDERFLOW, ERROR_TEXTFONT_NULL_PFONT, fill, fillA, fillAi, fillAlpha, fillB, fillBi, fillColor, fillG, fillGi, fillR, fillRi, G, HAS_NORMAL, hints, image, imageMode, MATRIX_STACK_DEPTH, NORMAL_MODE_AUTO, NORMAL_MODE_SHAPE, NORMAL_MODE_VERTEX, normalMode, normalX, normalY, normalZ, NX, NY, NZ, path, pixelCount, primaryGraphics, R, raw, reapplySettings, rectMode, SA, SB, setAmbient, settingsInited, SG, shape, shapeMode, SHINE, shininess, SINCOS_LENGTH, SINCOS_PRECISION, sinLUT, smooth, SPB, specularB, specularColor, specularG, specularR, SPG, sphereDetailU, sphereDetailV, sphereX, sphereY, sphereZ, SPR, SR, stroke, strokeA, strokeAi, strokeAlpha, strokeB, strokeBi, strokeCap, strokeColor, strokeG, strokeGi, strokeJoin, strokeR, strokeRi, strokeWeight, surface, SW, textAlign, textAlignY, textBreakCount, textBreakStart, textBreakStop, textBuffer, textFont, textLeading, textMode, textSize, textureImage, textureMode, textureU, textureV, textWidthBuffer, tint, tintA, tintAi, tintAlpha, tintB, tintBi, tintColor, tintG, tintGi, tintR, tintRi, TX, TY, TZ, U, V, VERTEX_FIELD_COUNT, vertexCount, vertices, VW, VX, VY, VZ, warnings
        • \n
      \n
        \n
      • \n\n\n

        Fields inherited from class processing.core.PImage

        \nALPHA_MASK, BLUE_MASK, format, GREEN_MASK, height, loaded, modified, mx1, mx2, my1, my2, parent, pixelDensity, pixelHeight, pixels, pixelWidth, RED_MASK, saveImageFormats, width
        • \n
      \n
        \n
      • \n\n\n

        Fields inherited from interface processing.core.PConstants

        \nADD, ALPHA, ALT, AMBIENT, ARC, ARGB, ARROW, BACKSPACE, BASELINE, BEVEL, BEZIER_VERTEX, BLEND, BLUR, BOTTOM, BOX, BREAK, BURN, CENTER, CHATTER, CHORD, CLAMP, CLOSE, CODED, COMPLAINT, CONTROL, CORNER, CORNERS, CROSS, CURVE_VERTEX, CUSTOM, DARKEST, DEG_TO_RAD, DELETE, DIAMETER, DIFFERENCE, DILATE, DIRECTIONAL, DISABLE_ASYNC_SAVEFRAME, DISABLE_BUFFER_READING, DISABLE_DEPTH_MASK, DISABLE_DEPTH_SORT, DISABLE_DEPTH_TEST, DISABLE_KEY_REPEAT, DISABLE_NATIVE_FONTS, DISABLE_OPENGL_ERRORS, DISABLE_OPTIMIZED_STROKE, DISABLE_STROKE_PERSPECTIVE, DISABLE_STROKE_PURE, DISABLE_TEXTURE_MIPMAPS, DODGE, DOWN, DXF, ELLIPSE, ENABLE_ASYNC_SAVEFRAME, ENABLE_BUFFER_READING, ENABLE_DEPTH_MASK, ENABLE_DEPTH_SORT, ENABLE_DEPTH_TEST, ENABLE_KEY_REPEAT, ENABLE_NATIVE_FONTS, ENABLE_OPENGL_ERRORS, ENABLE_OPTIMIZED_STROKE, ENABLE_STROKE_PERSPECTIVE, ENABLE_STROKE_PURE, ENABLE_TEXTURE_MIPMAPS, ENTER, EPSILON, ERODE, ESC, EXCLUSION, FX2D, GIF, GRAY, GROUP, HALF_PI, HAND, HARD_LIGHT, HINT_COUNT, HSB, IMAGE, INVERT, JAVA2D, JPEG, LANDSCAPE, LEFT, LIGHTEST, LINE, LINE_LOOP, LINE_STRIP, LINES, LINUX, MACOSX, MAX_FLOAT, MAX_INT, MIN_FLOAT, MIN_INT, MITER, MODEL, MODELVIEW, MOVE, MULTIPLY, NORMAL, OPAQUE, OPEN, OPENGL, ORTHOGRAPHIC, OTHER, OVERLAY, P2D, P3D, PATH, PDF, PERSPECTIVE, PI, PIE, platformNames, POINT, POINTS, POLYGON, PORTRAIT, POSTERIZE, PROBLEM, PROJECT, PROJECTION, QUAD, QUAD_BEZIER_VERTEX, QUAD_STRIP, QUADRATIC_VERTEX, QUADS, QUARTER_PI, RAD_TO_DEG, RADIUS, RECT, REPEAT, REPLACE, RETURN, RGB, RIGHT, ROUND, SCREEN, SHAPE, SHIFT, SOFT_LIGHT, SPAN, SPHERE, SPOT, SQUARE, SUBTRACT, SVG, TAB, TARGA, TAU, TEXT, THIRD_PI, THRESHOLD, TIFF, TOP, TRIANGLE, TRIANGLE_FAN, TRIANGLE_STRIP, TRIANGLES, TWO_PI, UP, VERTEX, WAIT, WHITESPACE, WINDOWS, X, Y, Z
        • \n
      \n
      • \n
    \n\n
      \n
    • \n\n\n

      Constructor Summary

      \n\n\n\n\n\n\n\n\n\n\n\n
      Constructors 
      Constructor and Description
      HandyRecorder(HandyRenderer h)\n
      Creates a new sketchy graphics context associated with the given handy renderer.
      \n
      HandyRecorder(processing.core.PApplet parentSketch)\n
      Creates a new sketchy graphics context associated with the given parent sketch.
      \n
      \n
      • \n
    \n\n
      \n
    • \n\n\n

      Method Summary

      \n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
      All Methods Instance Methods Concrete Methods 
      Modifier and TypeMethod and Description
      voidambientLight(float v1,\n float v2,\n float v3)\n
      Would set a ambient light source for this graphics context but ignores it in this case as this will\n be handled by the parent sketch.
      \n
      voidambientLight(float v1,\n float v2,\n float v3,\n float x,\n float y,\n float z)\n
      Would set a ambient light source for this graphics context but ignores it in this case as this will\n be handled by the parent sketch.
      \n
      voidarc(float x,\n float y,\n float aWidth,\n float aHeight,\n float start,\n float stop)\n
      Draws an arc along the outer edge of an ellipse defined by the x,y, w and h parameters.
      \n
      voidbeginCamera()\n
      Would start 3d camera position definition but ignored here as this will be handled by the parent sketch.
      \n
      voidbeginShape()\n
      Starts a new shape of type POLYGON.
      \n
      voidbeginShape(int mode)\n
      Starts a new shape of the type specified in the mode parameter.
      \n
      voidblendMode(int mode)\n
      Would set the blend mode for this graphics context but ignores it in this case as this will\n be handled by the parent sketch.
      \n
      voidbox(float bSize)\n
      Draws 3D cube with the given unit dimension.
      \n
      voidbox(float bWidth,\n float bHeight,\n float bDepth)\n
      Draws 3D box with the given dimensions.
      \n
      voidcamera()\n
      Would allow the default 3d camera position to be set but ignored here as this will be handled by the parent sketch.
      \n
      voidcurveVertex(float x,\n float y)\n
      Adds a 2d vertex to a shape or line that has curved edges.
      \n
      voidcurveVertex(float x,\n float y,\n float z)\n
      Adds a 3d vertex to a shape or line that has curved edges.
      \n
      voiddirectionalLight(float v1,\n float v2,\n float v3,\n float nx,\n float ny,\n float nz)\n
      Would set a directional light source for this graphics context but ignores it in this case as this will\n be handled by the parent sketch.
      \n
      voidellipse(float x,\n float y,\n float eWidth,\n float eHeight)\n
      Draws an ellipse using the given location and dimensions.
      \n
      voidendCamera()\n
      Would end 3d camera position definition but ignored here as this will be handled by the parent sketch.
      \n
      voidendShape()\n
      Ends a shape definition.
      \n
      voidendShape(int mode)\n
      Ends a shape definition.
      \n
      voidfrustum(float left,\n float right,\n float bottom,\n float top,\n float near,\n float far)\n
      Would allow the view frustum (clipping object) to be set but ignored here as this will be handled by the parent sketch.
      \n
      voidlightFalloff(float constant,\n float linear,\n float quadratic)\n
      Would set a light falloff for point, spot and ambient light sources for this graphics context but ignores \n it in this case as this will be handled by the parent sketch.
      \n
      voidlights()\n
      Would set the default 3d lighting for this graphics context but ignores it in this case as this will\n be handled by the parent sketch.
      \n
      voidlightSpecular(float v1,\n float v2,\n float v3)\n
      Would set a specular colour for light sources in this graphics context but ignores \n it in this case as this will be handled by the parent sketch.
      \n
      voidline(float x1,\n float y1,\n float x2,\n float y2)\n
      Draws a 2D line between the given coordinate pairs.
      \n
      voidline(float x1,\n float y1,\n float z1,\n float x2,\n float y2,\n float z2)\n
      Draws a 3D line between the given coordinate triplets.
      \n
      voidperspective()\n
      Would apply the default perspective settings but ignored here as this will be handled by the parent sketch.
      \n
      voidperspective(float fovy,\n float aspect,\n float zNear,\n float zFar)\n
      Would allow perspective settings to be changed but ignored here as this will be handled by the parent sketch.
      \n
      voidpoint(float x,\n float y)\n
      Draws 2D point at the given location.
      \n
      voidpoint(float x,\n float y,\n float z)\n
      Draws 3D point at the given location.
      \n
      voidpointLight(float v1,\n float v2,\n float v3,\n float x,\n float y,\n float z)\n
      Would set a point light source for this graphics context but ignores it in this case as this will\n be handled by the parent sketch.
      \n
      voidpopMatrix()\n
      Would retrieve a copy of the current transform matrix from the stack but ignored here as this\n will be handled by the parent sketch.
      \n
      voidprintMatrix()\n
      Would print the current transform matrix but ignored here as this will be handled by the parent sketch.
      \n
      voidpushMatrix()\n
      Would store a copy of the current transform matrix on the stack but ignored here as this\n will be handled by the parent sketch.
      \n
      voidquad(float x1,\n float y1,\n float x2,\n float y2,\n float x3,\n float y3,\n float x4,\n float y4)\n
      Draws a quadrilateral shape.
      \n
      voidrect(float x,\n float y,\n float rWidth,\n float rHeight)\n
      Draws a rectangle using the given location and dimensions.
      \n
      voidresetMatrix()\n
      Would reset the current transform matrix to its default transform but ignored here as this\n will be handled by the parent sketch.
      \n
      voidrotate(float angle)\n
      Would rotate the coordinate system by the given angle but ignored here as this will be\n handled by the parent sketch.
      \n
      voidrotate(float angle,\n float x,\n float y,\n float z)\n
      Would rotate the coordinate system by the given angles but ignored here as this will be\n handled by the parent sketch.
      \n
      voidrotateX(float angle)\n
      Would rotate the coordinate system around the x-axis in 3d space but ignored here as this\n will be handled by the parent sketch.
      \n
      voidrotateY(float angle)\n
      Would rotate the coordinate system around the y-axis in 3d space but ignored here as this\n will be handled by the parent sketch.
      \n
      voidrotateZ(float angle)\n
      Would rotate the coordinate system around the z-axis in 3d space but ignored here as this\n will be handled by the parent sketch.
      \n
      voidscale(float s)\n
      Would scale the coordinate system in all directions but ignored here as this will be handled\n by the parent sketch.
      \n
      voidscale(float sx,\n float sy)\n
      Would scale the coordinate system by the given x and y values but ignored here as this will be\n handled by the parent sketch.
      \n
      voidscale(float sx,\n float sy,\n float sz)\n
      Would scale the coordinate system by the given x, y and z values but ignored here as this will be\n handled by the parent sketch.
      \n
      voidspotLight(float v1,\n float v2,\n float v3,\n float x,\n float y,\n float z,\n float nx,\n float ny,\n float nz,\n float angle,\n float concentration)\n
      Would set a spotlight source for this graphics context but ignores it in this case as this will\n be handled by the parent sketch.
      \n
      voidtranslate(float x,\n float y)\n
      Would translate the coordinate system by the given x and y values but ignored here as this will\n be handled by the parent sketch.
      \n
      voidtranslate(float x,\n float y,\n float z)\n
      Would translate the coordinate system by the given x and y values but ignored here as this \n will be handled by the parent sketch.
      \n
      voidtriangle(float x1,\n float y1,\n float x2,\n float y2,\n float x3,\n float y3)\n
      Draws a triangle through the three pairs of coordinates.
      \n
      voidvertex(float x,\n float y)\n
      Adds a 2d vertex to a shape that was started with a call to beginShape() \n or one of its variants.
      \n
      voidvertex(float x,\n float y,\n float z)\n
      Adds a 3d vertex to a shape that was started with a call to beginShape() \n or one of its variants.
      \n
      \n
        \n
      • \n\n\n

        Methods inherited from class processing.core.PGraphics

        \nalpha, ambient, ambient, ambient, ambientFromCalc, applyMatrix, applyMatrix, applyMatrix, applyMatrix, applyMatrix, arc, arcImpl, attrib, attrib, attrib, attribColor, attribNormal, attribPosition, background, background, background, background, background, background, background, backgroundFromCalc, backgroundImpl, backgroundImpl, beginContour, beginDraw, beginPGL, beginRaw, bezier, bezier, bezierDetail, bezierInit, bezierInitCheck, bezierPoint, bezierTangent, bezierVertex, bezierVertex, bezierVertexCheck, bezierVertexCheck, blendModeImpl, blue, brightness, camera, checkSettings, clear, clip, clipImpl, color, color, color, color, color, color, color, color, color, colorCalc, colorCalc, colorCalc, colorCalc, colorCalc, colorCalc, colorCalcARGB, colorMode, colorMode, colorMode, colorMode, createFont, createShape, createShape, createShape, createShapeFamily, createShapePrimitive, createSurface, curve, curve, curveDetail, curveInit, curveInitCheck, curvePoint, curveTangent, curveTightness, curveVertexCheck, curveVertexCheck, curveVertexSegment, curveVertexSegment, defaultFontOrDeath, defaultFontOrDeath, defaultSettings, displayable, dispose, edge, ellipseImpl, ellipseMode, emissive, emissive, emissive, emissiveFromCalc, endContour, endDraw, endPGL, endRaw, fill, fill, fill, fill, fill, fill, fillFromCalc, filter, flush, getCache, getMatrix, getMatrix, getMatrix, getRaw, getStyle, getStyle, green, handleTextSize, haveRaw, hint, hue, image, image, image, imageImpl, imageMode, is2D, is2X, is3D, isGL, lerpColor, lerpColor, loadShader, loadShader, loadShape, loadShape, modelX, modelY, modelZ, noClip, noFill, noLights, normal, noSmooth, noStroke, noTexture, noTint, ortho, ortho, ortho, popStyle, printCamera, printProjection, processImageBeforeAsyncSave, pushStyle, quadraticVertex, quadraticVertex, reapplySettings, rect, rect, rectImpl, rectImpl, rectMode, red, removeCache, resetShader, resetShader, saturation, save, screenX, screenX, screenY, screenY, screenZ, setCache, setMatrix, setMatrix, setMatrix, setParent, setPath, setPrimary, setSize, shader, shader, shape, shape, shape, shape, shape, shapeMode, shearX, shearY, shininess, showDepthWarning, showDepthWarningXYZ, showException, showMethodWarning, showMissingWarning, showVariationWarning, showWarning, showWarning, smooth, smooth, specular, specular, specular, specularFromCalc, sphere, sphereDetail, sphereDetail, splineForward, stroke, stroke, stroke, stroke, stroke, stroke, strokeCap, strokeFromCalc, strokeJoin, strokeWeight, style, text, text, text, text, text, text, text, text, text, text, text, textAlign, textAlign, textAscent, textCharImpl, textCharModelImpl, textDescent, textFont, textFont, textFontImpl, textLeading, textLineAlignImpl, textLineImpl, textMode, textModeCheck, textSentence, textSentenceBreak, textSize, textSizeImpl, texture, textureMode, textureWrap, textWidth, textWidth, textWidth, textWidthImpl, tint, tint, tint, tint, tint, tint, tintFromCalc, vertex, vertex, vertex, vertexCheck, vertexTexture
        • \n
      \n
        \n
      • \n\n\n

        Methods inherited from class processing.core.PImage

        \nblend, blend, blendColor, blurAlpha, blurARGB, blurRGB, buildBlurKernel, checkAlpha, clone, copy, copy, copy, dilate, erode, filter, filter, get, get, get, getImage, getImpl, getModifiedX1, getModifiedX2, getModifiedY1, getModifiedY2, getNative, init, init, isLoaded, isModified, loadPixels, loadTIFF, mask, mask, opaque, resize, saveImageIO, saveTGA, saveTIFF, set, set, setImpl, setLoaded, setLoaded, setModified, setModified, updatePixels, updatePixels
        • \n
      \n
        \n
      • \n\n\n

        Methods inherited from class java.lang.Object

        \nequals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
        • \n
      \n
      • \n
    \n
    • \n
\n
\n
\n
    \n
  • \n\n
      \n
    • \n\n\n

      Constructor Detail

      \n\n\n\n
        \n
      • \n

        HandyRecorder

        \n
        public HandyRecorder(processing.core.PApplet parentSketch)
        \n
        Creates a new sketchy graphics context associated with the given parent sketch. This \n version will create an internal handy renderer with default properties.
        \n
        \n
        Parameters:
        \n
        parentSketch - Sketch with which this handy graphics object is to be associated.
        \n
        \n
        • \n
      \n\n\n\n
        \n
      • \n

        HandyRecorder

        \n
        public HandyRecorder(HandyRenderer h)
        \n
        Creates a new sketchy graphics context associated with the given handy renderer. This\n version allows the properties of the supplied handy renderer to be changed programmatically.
        \n
        \n
        Parameters:
        \n
        h - Handy renderer to use when drawing to this graphics context.
        \n
        \n
        • \n
      \n
      • \n
    \n\n
      \n
    • \n\n\n

      Method Detail

      \n\n\n\n
        \n
      • \n

        point

        \n
        public void point(float x,\n                  float y)
        \n
        Draws 2D point at the given location. Currently this draws the point in the same style as the\n default Processing renderer.
        \n
        \n
        Overrides:
        \n
        point in class processing.core.PGraphics
        \n
        Parameters:
        \n
        x - x coordinate of the point.
        \n
        y - y coordinate of the point.
        \n
        \n
        • \n
      \n\n\n\n
        \n
      • \n

        point

        \n
        public void point(float x,\n                  float y,\n                  float z)
        \n
        Draws 3D point at the given location. Currently this draws the point in the same style as the\n default Processing renderer.
        \n
        \n
        Overrides:
        \n
        point in class processing.core.PGraphics
        \n
        Parameters:
        \n
        x - x coordinate of the point.
        \n
        y - y coordinate of the point.
        \n
        z - z coordinate of the point.
        \n
        \n
        • \n
      \n\n\n\n
        \n
      • \n

        ellipse

        \n
        public void ellipse(float x,\n                    float y,\n                    float eWidth,\n                    float eHeight)
        \n
        Draws an ellipse using the given location and dimensions. By default the x,y coordinates\n will be centre of the ellipse, but the meanings of these parameters can be changed with\n Processing's ellipseMode() command.
        \n
        \n
        Overrides:
        \n
        ellipse in class processing.core.PGraphics
        \n
        Parameters:
        \n
        x - x coordinate of the ellipse's position
        \n
        y - y coordinate of the ellipse's position.
        \n
        eWidth - Width of the ellipse (but see modifications possible with ellipseMode())
        \n
        eHeight - Height of the ellipse (but see modifications possible with ellipseMode())
        \n
        \n
        • \n
      \n\n\n\n
        \n
      • \n

        rect

        \n
        public void rect(float x,\n                 float y,\n                 float rWidth,\n                 float rHeight)
        \n
        Draws a rectangle using the given location and dimensions. By default the x,y coordinates\n will be the top left of the rectangle, but the meanings of these parameters can be \n changed with Processing's rectMode() command.
        \n
        \n
        Overrides:
        \n
        rect in class processing.core.PGraphics
        \n
        Parameters:
        \n
        x - x coordinate of the rectangle position
        \n
        y - y coordinate of the rectangle position.
        \n
        rWidth - Width of the rectangle (but see modifications possible with rectMode())
        \n
        rHeight - Height of the rectangle (but see modifications possible with rectMode())
        \n
        \n
        • \n
      \n\n\n\n
        \n
      • \n

        triangle

        \n
        public void triangle(float x1,\n                     float y1,\n                     float x2,\n                     float y2,\n                     float x3,\n                     float y3)
        \n
        Draws a triangle through the three pairs of coordinates.
        \n
        \n
        Overrides:
        \n
        triangle in class processing.core.PGraphics
        \n
        Parameters:
        \n
        x1 - x coordinate of the first triangle vertex.
        \n
        y1 - y coordinate of the first triangle vertex.
        \n
        x2 - x coordinate of the second triangle vertex.
        \n
        y2 - y coordinate of the second triangle vertex.
        \n
        x3 - x coordinate of the third triangle vertex.
        \n
        y3 - y coordinate of the third triangle vertex.
        \n
        \n
        • \n
      \n\n\n\n
        \n
      • \n

        quad

        \n
        public void quad(float x1,\n                 float y1,\n                 float x2,\n                 float y2,\n                 float x3,\n                 float y3,\n                 float x4,\n                 float y4)
        \n
        Draws a quadrilateral shape. Similar to a rectangle but angles not constrained to 90 degrees.\n Coordinates can proceed in either a clockwise or anti-clockwise direction.
        \n
        \n
        Overrides:
        \n
        quad in class processing.core.PGraphics
        \n
        Parameters:
        \n
        x1 - x coordinate of the first quadrilateral vertex.
        \n
        y1 - y coordinate of the first quadrilateral vertex.
        \n
        x2 - x coordinate of the second quadrilateral vertex.
        \n
        y2 - y coordinate of the second quadrilateral vertex.
        \n
        x3 - x coordinate of the third quadrilateral vertex.
        \n
        y3 - y coordinate of the third quadrilateral vertex.
        \n
        x4 - x coordinate of the fourth quadrilateral vertex.
        \n
        y4 - y coordinate of the fourth quadrilateral vertex.
        \n
        \n
        • \n
      \n\n\n\n
        \n
      • \n

        arc

        \n
        public void arc(float x,\n                float y,\n                float aWidth,\n                float aHeight,\n                float start,\n                float stop)
        \n
        Draws an arc along the outer edge of an ellipse defined by the x,y, w and h parameters.\n This version allows the maximum random offset of the arc to be set explicitly.
        \n
        \n
        Overrides:
        \n
        arc in class processing.core.PGraphics
        \n
        Parameters:
        \n
        x - x coordinate of the ellipse's position around which this arc is defined.
        \n
        y - y coordinate of the ellipse's position around which this arc is defined
        \n
        aWidth - Width of the ellipse around which this arc is defined (but see modifications possible with ellipseMode())
        \n
        aHeight - Height of the ellipse around which this arc is defined (but see modifications possible with ellipseMode())
        \n
        start - Angle to start the arc in radians.
        \n
        stop - Angle to stop the arc in radians.
        \n
        \n
        • \n
      \n\n\n\n
        \n
      • \n

        beginShape

        \n
        public void beginShape()
        \n
        Starts a new shape of type POLYGON. This must be paired with a call to \n endShape() or one of its variants.
        \n
        \n
        Overrides:
        \n
        beginShape in class processing.core.PGraphics
        \n
        \n
        • \n
      \n\n\n\n
        \n
      • \n

        beginShape

        \n
        public void beginShape(int mode)
        \n
        Starts a new shape of the type specified in the mode parameter. This must be paired\n with a call to endShape() or one of its variants.
        \n
        \n
        Overrides:
        \n
        beginShape in class processing.core.PGraphics
        \n
        Parameters:
        \n
        mode - either POINTS, LINES, TRIANGLES, TRIANGLE_FAN, TRIANGLE_STRIP, QUADS, QUAD_STRIP
        \n
        \n
        • \n
      \n\n\n\n
        \n
      • \n

        vertex

        \n
        public void vertex(float x,\n                   float y)
        \n
        Adds a 2d vertex to a shape that was started with a call to beginShape() \n or one of its variants.
        \n
        \n
        Overrides:
        \n
        vertex in class processing.core.PGraphics
        \n
        Parameters:
        \n
        x - x coordinate of vertex to add.
        \n
        y - y coordinate of vertex to add.
        \n
        \n
        • \n
      \n\n\n\n
        \n
      • \n

        vertex

        \n
        public void vertex(float x,\n                   float y,\n                   float z)
        \n
        Adds a 3d vertex to a shape that was started with a call to beginShape() \n or one of its variants.
        \n
        \n
        Overrides:
        \n
        vertex in class processing.core.PGraphics
        \n
        Parameters:
        \n
        x - x coordinate of vertex to add.
        \n
        y - y coordinate of vertex to add.
        \n
        z - z coordinate of vertex to add.
        \n
        \n
        • \n
      \n\n\n\n
        \n
      • \n

        curveVertex

        \n
        public void curveVertex(float x,\n                        float y)
        \n
        Adds a 2d vertex to a shape or line that has curved edges. That shape should have been\n started with a call to beginShape() without any parameter.
        \n
        \n
        Overrides:
        \n
        curveVertex in class processing.core.PGraphics
        \n
        Parameters:
        \n
        x - x coordinate of vertex to add.
        \n
        y - y coordinate of vertex to add.
        \n
        \n
        • \n
      \n\n\n\n
        \n
      • \n

        curveVertex

        \n
        public void curveVertex(float x,\n                        float y,\n                        float z)
        \n
        Adds a 3d vertex to a shape or line that has curved edges. That shape should have been\n started with a call to beginShape() without any parameter.
        \n
        \n
        Overrides:
        \n
        curveVertex in class processing.core.PGraphics
        \n
        Parameters:
        \n
        x - x coordinate of vertex to add.
        \n
        y - y coordinate of vertex to add.
        \n
        z - z coordinate of vertex to add.
        \n
        \n
        • \n
      \n\n\n\n
        \n
      • \n

        endShape

        \n
        public void endShape()
        \n
        Ends a shape definition. This should have been paired with a call to beginShape()\n or one of its variants. Note that this version will not close the shape if the last vertex does \n not match the first one.
        \n
        \n
        Overrides:
        \n
        endShape in class processing.core.PGraphics
        \n
        \n
        • \n
      \n\n\n\n
        \n
      • \n

        endShape

        \n
        public void endShape(int mode)
        \n
        Ends a shape definition. This should have been paired with a call to beginShape() \n or one of its variants. If the mode parameter CLOSE the shape will be closed.
        \n
        \n
        Overrides:
        \n
        endShape in class processing.core.PGraphics
        \n
        \n
        • \n
      \n\n\n\n
        \n
      • \n

        box

        \n
        public void box(float bSize)
        \n
        Draws 3D cube with the given unit dimension.
        \n
        \n
        Overrides:
        \n
        box in class processing.core.PGraphics
        \n
        Parameters:
        \n
        bSize - Size of each dimension of the cube.
        \n
        \n
        • \n
      \n\n\n\n
        \n
      • \n

        box

        \n
        public void box(float bWidth,\n                float bHeight,\n                float bDepth)
        \n
        Draws 3D box with the given dimensions.
        \n
        \n
        Overrides:
        \n
        box in class processing.core.PGraphics
        \n
        Parameters:
        \n
        bWidth - Width of the box.
        \n
        bHeight - Height of the box.
        \n
        bDepth - Depth of the box.
        \n
        \n
        • \n
      \n\n\n\n
        \n
      • \n

        line

        \n
        public void line(float x1,\n                 float y1,\n                 float x2,\n                 float y2)
        \n
        Draws a 2D line between the given coordinate pairs.
        \n
        \n
        Overrides:
        \n
        line in class processing.core.PGraphics
        \n
        Parameters:
        \n
        x1 - x coordinate of the start of the line.
        \n
        y1 - y coordinate of the start of the line.
        \n
        x2 - x coordinate of the end of the line.
        \n
        y2 - y coordinate of the end of the line.
        \n
        \n
        • \n
      \n\n\n\n
        \n
      • \n

        line

        \n
        public void line(float x1,\n                 float y1,\n                 float z1,\n                 float x2,\n                 float y2,\n                 float z2)
        \n
        Draws a 3D line between the given coordinate triplets.
        \n
        \n
        Overrides:
        \n
        line in class processing.core.PGraphics
        \n
        Parameters:
        \n
        x1 - x coordinate of the start of the line.
        \n
        y1 - y coordinate of the start of the line.
        \n
        z1 - z coordinate of the start of the line.
        \n
        x2 - x coordinate of the end of the line.
        \n
        y2 - y coordinate of the end of the line.
        \n
        z2 - z coordinate of the end of the line.
        \n
        \n
        • \n
      \n\n\n\n
        \n
      • \n

        translate

        \n
        public void translate(float x,\n                      float y)
        \n
        Would translate the coordinate system by the given x and y values but ignored here as this will\n be handled by the parent sketch.
        \n
        \n
        Overrides:
        \n
        translate in class processing.core.PGraphics
        \n
        Parameters:
        \n
        x - x value to translate by.
        \n
        y - y value to translate by.
        \n
        \n
        • \n
      \n\n\n\n
        \n
      • \n

        translate

        \n
        public void translate(float x,\n                      float y,\n                      float z)
        \n
        Would translate the coordinate system by the given x and y values but ignored here as this \n will be handled by the parent sketch.
        \n
        \n
        Overrides:
        \n
        translate in class processing.core.PGraphics
        \n
        Parameters:
        \n
        x - x value to translate by.
        \n
        y - y value to translate by.
        \n
        z - z value to translate by.
        \n
        \n
        • \n
      \n\n\n\n
        \n
      • \n

        scale

        \n
        public void scale(float s)
        \n
        Would scale the coordinate system in all directions but ignored here as this will be handled\n by the parent sketch.
        \n
        \n
        Overrides:
        \n
        scale in class processing.core.PGraphics
        \n
        Parameters:
        \n
        s - value to scale all axes by.
        \n
        \n
        • \n
      \n\n\n\n
        \n
      • \n

        scale

        \n
        public void scale(float sx,\n                  float sy)
        \n
        Would scale the coordinate system by the given x and y values but ignored here as this will be\n handled by the parent sketch.
        \n
        \n
        Overrides:
        \n
        scale in class processing.core.PGraphics
        \n
        Parameters:
        \n
        sx - x value to scale by.
        \n
        sy - y value to scale by.
        \n
        \n
        • \n
      \n\n\n\n
        \n
      • \n

        scale

        \n
        public void scale(float sx,\n                  float sy,\n                  float sz)
        \n
        Would scale the coordinate system by the given x, y and z values but ignored here as this will be\n handled by the parent sketch.
        \n
        \n
        Overrides:
        \n
        scale in class processing.core.PGraphics
        \n
        Parameters:
        \n
        sx - x value to scale by.
        \n
        sy - y value to scale by.
        \n
        sz - z value to scale by.
        \n
        \n
        • \n
      \n\n\n\n
        \n
      • \n

        rotate

        \n
        public void rotate(float angle)
        \n
        Would rotate the coordinate system by the given angle but ignored here as this will be\n handled by the parent sketch.
        \n
        \n
        Overrides:
        \n
        rotate in class processing.core.PGraphics
        \n
        Parameters:
        \n
        angle - Angle by which to rotate the coordinate system (ignored).
        \n
        \n
        • \n
      \n\n\n\n
        \n
      • \n

        rotateX

        \n
        public void rotateX(float angle)
        \n
        Would rotate the coordinate system around the x-axis in 3d space but ignored here as this\n will be handled by the parent sketch.
        \n
        \n
        Overrides:
        \n
        rotateX in class processing.core.PGraphics
        \n
        Parameters:
        \n
        angle - Angle by which to rotate around the x-axis (ignored).
        \n
        \n
        • \n
      \n\n\n\n
        \n
      • \n

        rotateY

        \n
        public void rotateY(float angle)
        \n
        Would rotate the coordinate system around the y-axis in 3d space but ignored here as this\n will be handled by the parent sketch.
        \n
        \n
        Overrides:
        \n
        rotateY in class processing.core.PGraphics
        \n
        Parameters:
        \n
        angle - Angle by which to rotate around the y-axis (ignored).
        \n
        \n
        • \n
      \n\n\n\n
        \n
      • \n

        rotateZ

        \n
        public void rotateZ(float angle)
        \n
        Would rotate the coordinate system around the z-axis in 3d space but ignored here as this\n will be handled by the parent sketch.
        \n
        \n
        Overrides:
        \n
        rotateZ in class processing.core.PGraphics
        \n
        Parameters:
        \n
        angle - Angle by which to rotate around the z-axis (ignored).
        \n
        \n
        • \n
      \n\n\n\n
        \n
      • \n

        rotate

        \n
        public void rotate(float angle,\n                   float x,\n                   float y,\n                   float z)
        \n
        Would rotate the coordinate system by the given angles but ignored here as this will be\n handled by the parent sketch.
        \n
        \n
        Overrides:
        \n
        rotate in class processing.core.PGraphics
        \n
        Parameters:
        \n
        angle - Angle of rotation (ignored).
        \n
        x - x component of vector around which to rotate (ignored)
        \n
        y - y component of vector around which to rotate (ignored)
        \n
        z - z component of vector around which to rotate (ignored)
        \n
        \n
        • \n
      \n\n\n\n
        \n
      • \n

        pushMatrix

        \n
        public void pushMatrix()
        \n
        Would store a copy of the current transform matrix on the stack but ignored here as this\n will be handled by the parent sketch.
        \n
        \n
        Overrides:
        \n
        pushMatrix in class processing.core.PGraphics
        \n
        \n
        • \n
      \n\n\n\n
        \n
      • \n

        popMatrix

        \n
        public void popMatrix()
        \n
        Would retrieve a copy of the current transform matrix from the stack but ignored here as this\n will be handled by the parent sketch.
        \n
        \n
        Overrides:
        \n
        popMatrix in class processing.core.PGraphics
        \n
        \n
        • \n
      \n\n\n\n
        \n
      • \n

        resetMatrix

        \n
        public void resetMatrix()
        \n
        Would reset the current transform matrix to its default transform but ignored here as this\n will be handled by the parent sketch.
        \n
        \n
        Overrides:
        \n
        resetMatrix in class processing.core.PGraphics
        \n
        \n
        • \n
      \n\n\n\n
        \n
      • \n

        printMatrix

        \n
        public void printMatrix()
        \n
        Would print the current transform matrix but ignored here as this will be handled by the parent sketch.
        \n
        \n
        Overrides:
        \n
        printMatrix in class processing.core.PGraphics
        \n
        \n
        • \n
      \n\n\n\n
        \n
      • \n

        beginCamera

        \n
        public void beginCamera()
        \n
        Would start 3d camera position definition but ignored here as this will be handled by the parent sketch.
        \n
        \n
        Overrides:
        \n
        beginCamera in class processing.core.PGraphics
        \n
        \n
        • \n
      \n\n\n\n
        \n
      • \n

        camera

        \n
        public void camera()
        \n
        Would allow the default 3d camera position to be set but ignored here as this will be handled by the parent sketch.
        \n
        \n
        Overrides:
        \n
        camera in class processing.core.PGraphics
        \n
        \n
        • \n
      \n\n\n\n
        \n
      • \n

        endCamera

        \n
        public void endCamera()
        \n
        Would end 3d camera position definition but ignored here as this will be handled by the parent sketch.
        \n
        \n
        Overrides:
        \n
        endCamera in class processing.core.PGraphics
        \n
        \n
        • \n
      \n\n\n\n
        \n
      • \n

        frustum

        \n
        public void frustum(float left,\n                    float right,\n                    float bottom,\n                    float top,\n                    float near,\n                    float far)
        \n
        Would allow the view frustum (clipping object) to be set but ignored here as this will be handled by the parent sketch.
        \n
        \n
        Overrides:
        \n
        frustum in class processing.core.PGraphics
        \n
        \n
        • \n
      \n\n\n\n
        \n
      • \n

        perspective

        \n
        public void perspective()
        \n
        Would apply the default perspective settings but ignored here as this will be handled by the parent sketch.
        \n
        \n
        Overrides:
        \n
        perspective in class processing.core.PGraphics
        \n
        \n
        • \n
      \n\n\n\n
        \n
      • \n

        perspective

        \n
        public void perspective(float fovy,\n                        float aspect,\n                        float zNear,\n                        float zFar)
        \n
        Would allow perspective settings to be changed but ignored here as this will be handled by the parent sketch.
        \n
        \n
        Overrides:
        \n
        perspective in class processing.core.PGraphics
        \n
        \n
        • \n
      \n\n\n\n
        \n
      • \n

        blendMode

        \n
        public void blendMode(int mode)
        \n
        Would set the blend mode for this graphics context but ignores it in this case as this will\n be handled by the parent sketch.
        \n
        \n
        Overrides:
        \n
        blendMode in class processing.core.PGraphics
        \n
        \n
        • \n
      \n\n\n\n
        \n
      • \n

        lights

        \n
        public void lights()
        \n
        Would set the default 3d lighting for this graphics context but ignores it in this case as this will\n be handled by the parent sketch.
        \n
        \n
        Overrides:
        \n
        lights in class processing.core.PGraphics
        \n
        \n
        • \n
      \n\n\n\n
        \n
      • \n

        pointLight

        \n
        public void pointLight(float v1,\n                       float v2,\n                       float v3,\n                       float x,\n                       float y,\n                       float z)
        \n
        Would set a point light source for this graphics context but ignores it in this case as this will\n be handled by the parent sketch.
        \n
        \n
        Overrides:
        \n
        pointLight in class processing.core.PGraphics
        \n
        \n
        • \n
      \n\n\n\n
        \n
      • \n

        ambientLight

        \n
        public void ambientLight(float v1,\n                         float v2,\n                         float v3)
        \n
        Would set a ambient light source for this graphics context but ignores it in this case as this will\n be handled by the parent sketch.
        \n
        \n
        Overrides:
        \n
        ambientLight in class processing.core.PGraphics
        \n
        \n
        • \n
      \n\n\n\n
        \n
      • \n

        ambientLight

        \n
        public void ambientLight(float v1,\n                         float v2,\n                         float v3,\n                         float x,\n                         float y,\n                         float z)
        \n
        Would set a ambient light source for this graphics context but ignores it in this case as this will\n be handled by the parent sketch.
        \n
        \n
        Overrides:
        \n
        ambientLight in class processing.core.PGraphics
        \n
        \n
        • \n
      \n\n\n\n
        \n
      • \n

        directionalLight

        \n
        public void directionalLight(float v1,\n                             float v2,\n                             float v3,\n                             float nx,\n                             float ny,\n                             float nz)
        \n
        Would set a directional light source for this graphics context but ignores it in this case as this will\n be handled by the parent sketch.
        \n
        \n
        Overrides:
        \n
        directionalLight in class processing.core.PGraphics
        \n
        \n
        • \n
      \n\n\n\n
        \n
      • \n

        spotLight

        \n
        public void spotLight(float v1,\n                      float v2,\n                      float v3,\n                      float x,\n                      float y,\n                      float z,\n                      float nx,\n                      float ny,\n                      float nz,\n                      float angle,\n                      float concentration)
        \n
        Would set a spotlight source for this graphics context but ignores it in this case as this will\n be handled by the parent sketch.
        \n
        \n
        Overrides:
        \n
        spotLight in class processing.core.PGraphics
        \n
        \n
        • \n
      \n\n\n\n
        \n
      • \n

        lightFalloff

        \n
        public void lightFalloff(float constant,\n                         float linear,\n                         float quadratic)
        \n
        Would set a light falloff for point, spot and ambient light sources for this graphics context but ignores \n it in this case as this will be handled by the parent sketch.
        \n
        \n
        Overrides:
        \n
        lightFalloff in class processing.core.PGraphics
        \n
        \n
        • \n
      \n\n\n\n
        \n
      • \n

        lightSpecular

        \n
        public void lightSpecular(float v1,\n                          float v2,\n                          float v3)
        \n
        Would set a specular colour for light sources in this graphics context but ignores \n it in this case as this will be handled by the parent sketch.
        \n
        \n
        Overrides:
        \n
        lightSpecular in class processing.core.PGraphics
        \n
        \n
        • \n
      \n
      • \n
    \n
    • \n
\n
\n
\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n\n\n\n
\n\n
\n
\n\n\n
\n\n\n
\n\n\n\n" }, { "path": "Handy/reference/org/gicentre/handy/HandyRenderer.html", "content": "\n\n\n\n\nHandyRenderer\n\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n\n\n\n
\n\n
\n
\n
    \n
  • Summary: 
    • \n
  • Nested | 
    • \n
  • Field | 
    • \n
  • Constr | 
    • \n
  • Method
    • \n
\n\n
\n\n\n
\n\n\n
\n
org.gicentre.handy
\n

Class HandyRenderer

\n
\n
\n
    \n
  • java.lang.Object
    • \n
  • \n
      \n
    • org.gicentre.handy.HandyRenderer
      • \n
    \n
    • \n
\n
\n
    \n
  • \n
    \n
    \n
    public class HandyRenderer\nextends java.lang.Object
    \n
    The renderer that draws graphic primitives in a sketchy style. The style of sketchiness\n can be configured in this class. Based on an original idea by Nikolaus Gradwohl
    \n
    \n
    Version:
    \n
    2.0, 1st April, 2016.
    \n
    Author:
    \n
    Jo Wood, giCentre, City University London based on an idea by Nikolaus Gradwohl.
    \n
    \n
    • \n
\n
\n
\n
    \n
  • \n\n
      \n
    • \n\n\n

      Constructor Summary

      \n\n\n\n\n\n\n\n\n
      Constructors 
      Constructor and Description
      HandyRenderer(processing.core.PApplet parent)\n
      Creates a new HandyRender capable of using standard Processing drawing commands\n to render features in a sketchy hand-drawn style.
      \n
      \n
      • \n
    \n\n
      \n
    • \n\n\n

      Method Summary

      \n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
      All Methods Static Methods Instance Methods Concrete Methods 
      Modifier and TypeMethod and Description
      voidarc(float x,\n float y,\n float w,\n float h,\n float start,\n float stop)\n
      Draws an arc along the outer edge of an ellipse defined by the x,y, w and h parameters.
      \n
      voidbeginShape()\n
      Starts a new shape of type POLYGON.
      \n
      voidbeginShape(int mode)\n
      Starts a new shape of the type specified in the mode parameter.
      \n
      voidbox(float bSize)\n
      Draws 3D cube with the given unit dimension.
      \n
      voidbox(float bWidth,\n float bHeight,\n float bDepth)\n
      Draws 3D box with the given dimensions.
      \n
      static voidcopyGraphics(processing.core.PGraphics gSrc,\n processing.core.PGraphics gDst)\n
      Copies the settings from one graphics context to another.
      \n
      voidcurveVertex(float x,\n float y)\n
      Adds a 2d vertex to a shape or line that has curved edges.
      \n
      voidcurveVertex(float x,\n float y,\n float z)\n
      Adds a 3d vertex to a shape or line that has curved edges.
      \n
      voidellipse(float x,\n float y,\n float w,\n float h)\n
      Draws an ellipse using the given location and dimensions.
      \n
      voidendShape()\n
      Ends a shape definition.
      \n
      voidendShape(int mode)\n
      Ends a shape definition.
      \n
      booleanisHandy()\n
      Reports whether the renderer is currently set to draw in a sketchy style or not.
      \n
      voidline(float x1,\n float y1,\n float x2,\n float y2)\n
      Draws a 2D line between the given coordinate pairs.
      \n
      voidline(float x1,\n float y1,\n float z1,\n float x2,\n float y2,\n float z2)\n
      Draws a 3D line between the given coordinate triplets.
      \n
      voidpoint(float x,\n float y)\n
      Draws 2D point at the given location.
      \n
      voidpoint(float x,\n float y,\n float z)\n
      Draws 3D point at the given location.
      \n
      voidpolyLine(float[] xCoords,\n float[] yCoords)\n
      Draws a complex line that links the given coordinates.
      \n
      voidquad(float x1,\n float y1,\n float x2,\n float y2,\n float x3,\n float y3,\n float x4,\n float y4)\n
      Draws a quadrilateral shape.
      \n
      voidrect(float x,\n float y,\n float w,\n float h)\n
      Draws a rectangle using the given location and dimensions.
      \n
      voidresetStyles()\n
      Resets the sketchy styles to default values.
      \n
      voidsetBackgroundColour(int colour)\n
      Sets the background colour for closed shapes.
      \n
      voidsetBowing(float bowing)\n
      Sets the amount of 'bowing' of lines (contols the degree to which a straigh line appears as an 'I' or 'C').
      \n
      voidsetFillColour(int colour)\n
      Sets the fill colour for closed shapes.
      \n
      voidsetFillGap(float gap)\n
      Determines the gap between fill lines.
      \n
      voidsetFillWeight(float weight)\n
      Determines the thickness of fill lines.
      \n
      voidsetGraphics(processing.core.PGraphics graphics)\n
      Sets the graphics context into which all output is directed.
      \n
      voidsetHachureAngle(float degrees)\n
      Sets the angle for shading hachures.
      \n
      voidsetHachurePerturbationAngle(float degrees)\n
      Sets the maximum random perturbation in hachure angle per object.
      \n
      voidsetIsAlternating(boolean alternate)\n
      Determines whether or not an alternating fill stroke is used to shade shapes.
      \n
      voidsetIsHandy(boolean isHandy)\n
      Determines whether or not the renderer applies a hand-drawn sketchy appearance.
      \n
      voidsetOverrideFillColour(boolean override)\n
      Determines whether or not to override the fill colour that would otherwise be determined by\n the sketch's fillColor setting.
      \n
      voidsetOverrideStrokeColour(boolean override)\n
      Determines whether or not to override the stroke colour that would otherwise be determined by\n the sketch's strokeColor setting.
      \n
      voidsetRoughness(float roughness)\n
      Sets the general roughness of the sketch.
      \n
      voidsetSecondaryColour(int colour)\n
      Sets the secondary colour for line filling.
      \n
      voidsetSeed(long seed)\n
      Sets the seed used for random offsets when drawing.
      \n
      voidsetStrokeColour(int colour)\n
      Sets the stroke colour for rendering features.
      \n
      voidsetStrokeWeight(float weight)\n
      Determines the thickness of outer lines.
      \n
      voidsetUseSecondaryColour(boolean useSecondary)\n
      Determines whether or not a secondary colour is used for filling lines.
      \n
      voidshape(float[] xCoords,\n float[] yCoords)\n
      Draws a closed 2d polygon based on the given arrays of vertices.
      \n
      voidshape(float[] xCoords,\n float[] yCoords,\n boolean closeShape)\n
      Draws a 2d polygon based on the given arrays of vertices.
      \n
      voidshape(float[] xCoords,\n float[] yCoords,\n float[] zCoords)\n
      Draws a closed 3d polygon based on the given arrays of vertices.
      \n
      voidshape(float[] xCoords,\n float[] yCoords,\n float[] zCoords,\n boolean closeShape)\n
      Draws a 3d polygon based on the given arrays of vertices.
      \n
      static float[]toArray(java.util.List<java.lang.Float> list)\n
      Converts an array list of numeric values into a floating point array.
      \n
      voidtriangle(float x1,\n float y1,\n float x2,\n float y2,\n float x3,\n float y3)\n
      Draws a triangle through the three pairs of coordinates.
      \n
      voidvertex(float x,\n float y)\n
      Adds a 2d vertex to a shape that was started with a call to beginShape() \n or one of its variants.
      \n
      voidvertex(float x,\n float y,\n float z)\n
      Adds a 3d vertex to a shape that was started with a call to beginShape() \n or one of its variants.
      \n
      \n
        \n
      • \n\n\n

        Methods inherited from class java.lang.Object

        \nclone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
        • \n
      \n
      • \n
    \n
    • \n
\n
\n
\n
    \n
  • \n\n
      \n
    • \n\n\n

      Constructor Detail

      \n\n\n\n
        \n
      • \n

        HandyRenderer

        \n
        public HandyRenderer(processing.core.PApplet parent)
        \n
        Creates a new HandyRender capable of using standard Processing drawing commands\n to render features in a sketchy hand-drawn style.
        \n
        \n
        Parameters:
        \n
        parent - Parent sketch that will be drawn to.
        \n
        \n
        • \n
      \n
      • \n
    \n\n
      \n
    • \n\n\n

      Method Detail

      \n\n\n\n
        \n
      • \n

        setGraphics

        \n
        public void setGraphics(processing.core.PGraphics graphics)
        \n
        Sets the graphics context into which all output is directed. This method allows\n output to be redirected to print output, offscreen buffers etc.
        \n
        \n
        Parameters:
        \n
        graphics - New graphics context in which to render.
        \n
        \n
        • \n
      \n\n\n\n
        \n
      • \n

        copyGraphics

        \n
        public static void copyGraphics(processing.core.PGraphics gSrc,\n                                processing.core.PGraphics gDst)
        \n
        Copies the settings from one graphics context to another. This can be useful when creating an offscreen\n buffer that needs to have the same appearance settings as the current context.
        \n
        \n
        Parameters:
        \n
        gSrc - Source graphics context.
        \n
        gDst - Destination graphics context.
        \n
        \n
        • \n
      \n\n\n\n
        \n
      • \n

        setSeed

        \n
        public void setSeed(long seed)
        \n
        Sets the seed used for random offsets when drawing. This should be called if repeated calls\n to the same sketchy drawing methods should result in exactly the same rendering. If not called\n a vibrating appearance can be given to the rendering.
        \n
        \n
        Parameters:
        \n
        seed - Random number seed. This can be any whole number, generating the same random variation\n in rendering on each redraw.
        \n
        \n
        • \n
      \n\n\n\n
        \n
      • \n

        setIsHandy

        \n
        public void setIsHandy(boolean isHandy)
        \n
        Determines whether or not the renderer applies a hand-drawn sketchy appearance.\n If false, normal Processing drawing is used; if true a sketchy appearance using \n the current configuration style settings is used.
        \n
        \n
        Parameters:
        \n
        isHandy - Sketchy appearance used if true, or normal Processing appearance if false.
        \n
        \n
        • \n
      \n\n\n\n
        \n
      • \n

        isHandy

        \n
        public boolean isHandy()
        \n
        Reports whether the renderer is currently set to draw in a sketchy style or not.
        \n
        \n
        Returns:
        \n
        True if drawing in a sketchy style or false if not.
        \n
        \n
        • \n
      \n\n\n\n
        \n
      • \n

        setHachureAngle

        \n
        public void setHachureAngle(float degrees)
        \n
        Sets the angle for shading hachures.
        \n
        \n
        Parameters:
        \n
        degrees - Angle of hachures in degrees where 0 is vertical, 45 is NE-SW and 90 is horizontal.
        \n
        \n
        • \n
      \n\n\n\n
        \n
      • \n

        setHachurePerturbationAngle

        \n
        public void setHachurePerturbationAngle(float degrees)
        \n
        Sets the maximum random perturbation in hachure angle per object. This allows a hachure angle to\n vary between different shapes, but maintain approximate parallel hachure angle within a shape.
        \n
        \n
        Parameters:
        \n
        degrees - Maximum hachure perturbation angle.
        \n
        \n
        • \n
      \n\n\n\n
        \n
      • \n

        setBackgroundColour

        \n
        public void setBackgroundColour(int colour)
        \n
        Sets the background colour for closed shapes.
        \n
        \n
        Parameters:
        \n
        colour - Background colour.
        \n
        \n
        • \n
      \n\n\n\n
        \n
      • \n

        setFillColour

        \n
        public void setFillColour(int colour)
        \n
        Sets the fill colour for closed shapes. Note this will only have an effect if\n setOverrideFillColour() is true.
        \n
        \n
        Parameters:
        \n
        colour - Fill colour to use.
        \n
        \n
        • \n
      \n\n\n\n
        \n
      • \n

        setOverrideFillColour

        \n
        public void setOverrideFillColour(boolean override)
        \n
        Determines whether or not to override the fill colour that would otherwise be determined by\n the sketch's fillColor setting. If overridden, the colour is instead chosen from the \n value last provided to setFillColour().
        \n
        \n
        Parameters:
        \n
        override - If true the interior colour of features is determined by setFillColour,\n if not, it is determined by the parent sketch's fill colour setting.
        \n
        \n
        • \n
      \n\n\n\n
        \n
      • \n

        setStrokeColour

        \n
        public void setStrokeColour(int colour)
        \n
        Sets the stroke colour for rendering features. Note this will only have an effect if\n setOverrideStrokeColour() is true.
        \n
        \n
        Parameters:
        \n
        colour - Stroke colour to use.
        \n
        \n
        • \n
      \n\n\n\n
        \n
      • \n

        setOverrideStrokeColour

        \n
        public void setOverrideStrokeColour(boolean override)
        \n
        Determines whether or not to override the stroke colour that would otherwise be determined by\n the sketch's strokeColor setting. If overridden, the colour is instead chosen from the \n value last provided to setStrokeColour().
        \n
        \n
        Parameters:
        \n
        override - If true the stroke colour of features is determined by setStrokeColour,\n if not, it is determined by the parent sketch's stroke colour setting.
        \n
        \n
        • \n
      \n\n\n\n
        \n
      • \n

        setUseSecondaryColour

        \n
        public void setUseSecondaryColour(boolean useSecondary)
        \n
        Determines whether or not a secondary colour is used for filling lines.
        \n
        \n
        Parameters:
        \n
        useSecondary - If true a secondary colour is used.
        \n
        \n
        • \n
      \n\n\n\n
        \n
      • \n

        setSecondaryColour

        \n
        public void setSecondaryColour(int colour)
        \n
        Sets the secondary colour for line filling. Note this will only have an effect if\n setUseSecondaryColour() is true.
        \n
        \n
        Parameters:
        \n
        colour - Colour to tint line filling.
        \n
        \n
        • \n
      \n\n\n\n
        \n
      • \n

        setFillWeight

        \n
        public void setFillWeight(float weight)
        \n
        Determines the thickness of fill lines. If zero or negative, the thickness is\n proportional to the sketch's current strokeWeight.
        \n
        \n
        Parameters:
        \n
        weight - Fill weight in pixel units. If zero or negative, fill weight is based on the sketch's strokeWeight setting.
        \n
        \n
        • \n
      \n\n\n\n
        \n
      • \n

        setStrokeWeight

        \n
        public void setStrokeWeight(float weight)
        \n
        Determines the thickness of outer lines. If zero or negative, the thickness is\n proportional to the sketch's current strokeWeight.
        \n
        \n
        Parameters:
        \n
        weight - Stroke weight in pixel units. If zero or negative, stroke weight is based on the sketch's strokeWeight setting.
        \n
        \n
        • \n
      \n\n\n\n
        \n
      • \n

        setFillGap

        \n
        public void setFillGap(float gap)
        \n
        Determines the gap between fill lines. If zero, standard solid fill is used. If negative,\n the gap is proportional to the sketch's current strokeWeight.
        \n
        \n
        Parameters:
        \n
        gap - Gap between fill lines in pixel units. If zero, solid fill used; if negative, gap based on strokeWeight setting.
        \n
        \n
        • \n
      \n\n\n\n
        \n
      • \n

        setIsAlternating

        \n
        public void setIsAlternating(boolean alternate)
        \n
        Determines whether or not an alternating fill stroke is used to shade shapes. If true, shading appears\n as one long zig-zag stroke rather than many approximately parallel lines.
        \n
        \n
        Parameters:
        \n
        alternate - Zig-zag filling used if true, parallel lines if not.
        \n
        \n
        • \n
      \n\n\n\n
        \n
      • \n

        setRoughness

        \n
        public void setRoughness(float roughness)
        \n
        Sets the general roughness of the sketch. 1 is a typically neat sketchiness, 0 is very precise, 5 \n is very sketchy. Values are capped at 10.
        \n
        \n
        Parameters:
        \n
        roughness - The sketchiness of the rendering. The larger the number the more sketchy the rendering.
        \n
        \n
        • \n
      \n\n\n\n
        \n
      • \n

        setBowing

        \n
        public void setBowing(float bowing)
        \n
        Sets the amount of 'bowing' of lines (contols the degree to which a straigh line appears as an 'I' or 'C'). Applies to\n all straight lines such as rectangle boundaries, hachuring and the segments of a polygon boundary. A value of 0 means \n there is no systematic displacement away from the straight line path between the two endpoints in a line. A value of 1\n gives a small random bowing, 10 an extremely bowed appearance. Note that bowing is independent of other random variations\n in line geometry.Values are capped at 10.
        \n
        \n
        Parameters:
        \n
        bowing - The degree of bowing in the rendering if straight lines. The larger the number the more 'loopy' lines appear.
        \n
        \n
        • \n
      \n\n\n\n
        \n
      • \n

        resetStyles

        \n
        public void resetStyles()
        \n
        Resets the sketchy styles to default values.
        \n
        • \n
      \n\n\n\n
        \n
      • \n

        point

        \n
        public void point(float x,\n                  float y)
        \n
        Draws 2D point at the given location. Currently this draws the point in the same style as the\n default Processing renderer.
        \n
        \n
        Parameters:
        \n
        x - x coordinate of the point.
        \n
        y - y coordinate of the point.
        \n
        \n
        • \n
      \n\n\n\n
        \n
      • \n

        point

        \n
        public void point(float x,\n                  float y,\n                  float z)
        \n
        Draws 3D point at the given location. Currently this draws the point in the same style as the\n default Processing renderer.
        \n
        \n
        Parameters:
        \n
        x - x coordinate of the point.
        \n
        y - y coordinate of the point.
        \n
        z - z coordinate of the point.
        \n
        \n
        • \n
      \n\n\n\n
        \n
      • \n

        ellipse

        \n
        public void ellipse(float x,\n                    float y,\n                    float w,\n                    float h)
        \n
        Draws an ellipse using the given location and dimensions. By default the x,y coordinates\n will be centre of the ellipse, but the meanings of these parameters can be changed with\n Processing's ellipseMode() command.
        \n
        \n
        Parameters:
        \n
        x - x coordinate of the ellipse's position
        \n
        y - y coordinate of the ellipse's position.
        \n
        w - Width of the ellipse (but see modifications possible with ellipseMode())
        \n
        h - Height of the ellipse (but see modifications possible with ellipseMode())
        \n
        \n
        • \n
      \n\n\n\n
        \n
      • \n

        rect

        \n
        public void rect(float x,\n                 float y,\n                 float w,\n                 float h)
        \n
        Draws a rectangle using the given location and dimensions. By default the x,y coordinates\n will be the top left of the rectangle, but the meanings of these parameters can be \n changed with Processing's rectMode() command.
        \n
        \n
        Parameters:
        \n
        x - x coordinate of the rectangle position
        \n
        y - y coordinate of the rectangle position.
        \n
        w - Width of the rectangle (but see modifications possible with rectMode())
        \n
        h - Height of the rectangle (but see modifications possible with rectMode())
        \n
        \n
        • \n
      \n\n\n\n
        \n
      • \n

        triangle

        \n
        public void triangle(float x1,\n                     float y1,\n                     float x2,\n                     float y2,\n                     float x3,\n                     float y3)
        \n
        Draws a triangle through the three pairs of coordinates.
        \n
        \n
        Parameters:
        \n
        x1 - x coordinate of the first triangle vertex.
        \n
        y1 - y coordinate of the first triangle vertex.
        \n
        x2 - x coordinate of the second triangle vertex.
        \n
        y2 - y coordinate of the second triangle vertex.
        \n
        x3 - x coordinate of the third triangle vertex.
        \n
        y3 - y coordinate of the third triangle vertex.
        \n
        \n
        • \n
      \n\n\n\n
        \n
      • \n

        quad

        \n
        public void quad(float x1,\n                 float y1,\n                 float x2,\n                 float y2,\n                 float x3,\n                 float y3,\n                 float x4,\n                 float y4)
        \n
        Draws a quadrilateral shape. Similar to a rectangle but angles not constrained to 90 degrees.\n Coordinates can proceed in either a clockwise or anti-clockwise direction.
        \n
        \n
        Parameters:
        \n
        x1 - x coordinate of the first quadrilateral vertex.
        \n
        y1 - y coordinate of the first quadrilateral vertex.
        \n
        x2 - x coordinate of the second quadrilateral vertex.
        \n
        y2 - y coordinate of the second quadrilateral vertex.
        \n
        x3 - x coordinate of the third quadrilateral vertex.
        \n
        y3 - y coordinate of the third quadrilateral vertex.
        \n
        x4 - x coordinate of the fourth quadrilateral vertex.
        \n
        y4 - y coordinate of the fourth quadrilateral vertex.
        \n
        \n
        • \n
      \n\n\n\n
        \n
      • \n

        arc

        \n
        public void arc(float x,\n                float y,\n                float w,\n                float h,\n                float start,\n                float stop)
        \n
        Draws an arc along the outer edge of an ellipse defined by the x,y, w and h parameters.\n This version allows the maximum random offset of the arc to be set explicitly.
        \n
        \n
        Parameters:
        \n
        x - x coordinate of the ellipse's position around which this arc is defined.
        \n
        y - y coordinate of the ellipse's position around which this arc is defined
        \n
        w - Width of the ellipse around which this arc is defined (but see modifications possible with ellipseMode())
        \n
        h - Height of the ellipse around which this arc is defined (but see modifications possible with ellipseMode())
        \n
        start - Angle to start the arc in radians.
        \n
        stop - Angle to stop the arc in radians.
        \n
        \n
        • \n
      \n\n\n\n
        \n
      • \n

        beginShape

        \n
        public void beginShape()
        \n
        Starts a new shape of type POLYGON. This must be paired with a call to \n endShape() or one of its variants.
        \n
        • \n
      \n\n\n\n
        \n
      • \n

        beginShape

        \n
        public void beginShape(int mode)
        \n
        Starts a new shape of the type specified in the mode parameter. This must be paired\n with a call to endShape() or one of its variants.
        \n
        \n
        Parameters:
        \n
        mode - either POINTS, LINES, TRIANGLES, TRIANGLE_FAN, TRIANGLE_STRIP, QUADS, QUAD_STRIP
        \n
        \n
        • \n
      \n\n\n\n
        \n
      • \n

        vertex

        \n
        public void vertex(float x,\n                   float y)
        \n
        Adds a 2d vertex to a shape that was started with a call to beginShape() \n or one of its variants.
        \n
        \n
        Parameters:
        \n
        x - x coordinate of vertex to add.
        \n
        y - y coordinate of vertex to add.
        \n
        \n
        • \n
      \n\n\n\n
        \n
      • \n

        vertex

        \n
        public void vertex(float x,\n                   float y,\n                   float z)
        \n
        Adds a 3d vertex to a shape that was started with a call to beginShape() \n or one of its variants.
        \n
        \n
        Parameters:
        \n
        x - x coordinate of vertex to add.
        \n
        y - y coordinate of vertex to add.
        \n
        z - z coordinate of vertex to add.
        \n
        \n
        • \n
      \n\n\n\n
        \n
      • \n

        curveVertex

        \n
        public void curveVertex(float x,\n                        float y)
        \n
        Adds a 2d vertex to a shape or line that has curved edges. That shape should have been\n started with a call to beginShape() without any parameter.
        \n
        \n
        Parameters:
        \n
        x - x coordinate of vertex to add.
        \n
        y - y coordinate of vertex to add.
        \n
        \n
        • \n
      \n\n\n\n
        \n
      • \n

        curveVertex

        \n
        public void curveVertex(float x,\n                        float y,\n                        float z)
        \n
        Adds a 3d vertex to a shape or line that has curved edges. That shape should have been\n started with a call to beginShape() without any parameter.
        \n
        \n
        Parameters:
        \n
        x - x coordinate of vertex to add.
        \n
        y - y coordinate of vertex to add.
        \n
        z - z coordinate of vertex to add.
        \n
        \n
        • \n
      \n\n\n\n
        \n
      • \n

        endShape

        \n
        public void endShape()
        \n
        Ends a shape definition. This should have been paired with a call to beginShape()\n or one of its variants. Note that this version will not close the shape if the last vertex does \n not match the first one.
        \n
        • \n
      \n\n\n\n
        \n
      • \n

        endShape

        \n
        public void endShape(int mode)
        \n
        Ends a shape definition. This should have been paired with a call to beginShape() \n or one of its variants. If the mode parameter CLOSE the shape will be closed.
        \n
        \n
        Parameters:
        \n
        mode - Type of shape closure.
        \n
        \n
        • \n
      \n\n\n\n
        \n
      • \n

        box

        \n
        public void box(float bSize)
        \n
        Draws 3D cube with the given unit dimension.
        \n
        \n
        Parameters:
        \n
        bSize - Size of each dimension of the cube.
        \n
        \n
        • \n
      \n\n\n\n
        \n
      • \n

        box

        \n
        public void box(float bWidth,\n                float bHeight,\n                float bDepth)
        \n
        Draws 3D box with the given dimensions.
        \n
        \n
        Parameters:
        \n
        bWidth - Width of the box.
        \n
        bHeight - Height of the box.
        \n
        bDepth - Depth of the box.
        \n
        \n
        • \n
      \n\n\n\n
        \n
      • \n

        shape

        \n
        public void shape(float[] xCoords,\n                  float[] yCoords)
        \n
        Draws a closed 2d polygon based on the given arrays of vertices.
        \n
        \n
        Parameters:
        \n
        xCoords - x coordinates of the shape.
        \n
        yCoords - y coordinates of the shape.
        \n
        \n
        • \n
      \n\n\n\n
        \n
      • \n

        shape

        \n
        public void shape(float[] xCoords,\n                  float[] yCoords,\n                  float[] zCoords)
        \n
        Draws a closed 3d polygon based on the given arrays of vertices.
        \n
        \n
        Parameters:
        \n
        xCoords - x coordinates of the shape.
        \n
        yCoords - y coordinates of the shape.
        \n
        zCoords - z coordinates of the shape.
        \n
        \n
        • \n
      \n\n\n\n
        \n
      • \n

        shape

        \n
        public void shape(float[] xCoords,\n                  float[] yCoords,\n                  boolean closeShape)
        \n
        Draws a 2d polygon based on the given arrays of vertices. This version can \n draw either open or closed shapes.
        \n
        \n
        Parameters:
        \n
        xCoords - x coordinates of the shape.
        \n
        yCoords - y coordinates of the shape.
        \n
        closeShape - Boundary of shape will be closed if true.
        \n
        \n
        • \n
      \n\n\n\n
        \n
      • \n

        shape

        \n
        public void shape(float[] xCoords,\n                  float[] yCoords,\n                  float[] zCoords,\n                  boolean closeShape)
        \n
        Draws a 3d polygon based on the given arrays of vertices. This version can \n draw either open or closed shapes.
        \n
        \n
        Parameters:
        \n
        xCoords - x coordinates of the shape.
        \n
        yCoords - y coordinates of the shape.
        \n
        zCoords - z coordinates of the shape.
        \n
        closeShape - Boundary of shape will be closed if true.
        \n
        \n
        • \n
      \n\n\n\n
        \n
      • \n

        polyLine

        \n
        public void polyLine(float[] xCoords,\n                     float[] yCoords)
        \n
        Draws a complex line that links the given coordinates.
        \n
        \n
        Parameters:
        \n
        xCoords - x coordinates of the line.
        \n
        yCoords - y coordinates of the line.
        \n
        \n
        • \n
      \n\n\n\n
        \n
      • \n

        line

        \n
        public void line(float x1,\n                 float y1,\n                 float x2,\n                 float y2)
        \n
        Draws a 2D line between the given coordinate pairs.
        \n
        \n
        Parameters:
        \n
        x1 - x coordinate of the start of the line.
        \n
        y1 - y coordinate of the start of the line.
        \n
        x2 - x coordinate of the end of the line.
        \n
        y2 - y coordinate of the end of the line.
        \n
        \n
        • \n
      \n\n\n\n
        \n
      • \n

        line

        \n
        public void line(float x1,\n                 float y1,\n                 float z1,\n                 float x2,\n                 float y2,\n                 float z2)
        \n
        Draws a 3D line between the given coordinate triplets.
        \n
        \n
        Parameters:
        \n
        x1 - x coordinate of the start of the line.
        \n
        y1 - y coordinate of the start of the line.
        \n
        z1 - z coordinate of the start of the line.
        \n
        x2 - x coordinate of the end of the line.
        \n
        y2 - y coordinate of the end of the line.
        \n
        z2 - z coordinate of the end of the line.
        \n
        \n
        • \n
      \n\n\n\n
        \n
      • \n

        toArray

        \n
        public static float[] toArray(java.util.List<java.lang.Float> list)
        \n
        Converts an array list of numeric values into a floating point array.\n Useful for methods that require primitive arrays of floats based on a dynamic collection.
        \n
        \n
        Parameters:
        \n
        list - List of numbers to convert.
        \n
        Returns:
        \n
        Array of floats representing the list.
        \n
        \n
        • \n
      \n
      • \n
    \n
    • \n
\n
\n
\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n\n\n\n
\n\n
\n
\n
    \n
  • Summary: 
    • \n
  • Nested | 
    • \n
  • Field | 
    • \n
  • Constr | 
    • \n
  • Method
    • \n
\n\n
\n\n\n
\n\n\n\n" }, { "path": "Handy/reference/org/gicentre/handy/Simplifier.html", "content": "\n\n\n\n\nSimplifier\n\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n\n\n\n
\n\n
\n
\n
    \n
  • Summary: 
    • \n
  • Nested | 
    • \n
  • Field | 
    • \n
  • Constr | 
    • \n
  • Method
    • \n
\n\n
\n\n\n
\n\n\n
\n
org.gicentre.handy
\n

Class Simplifier

\n
\n
\n
    \n
  • java.lang.Object
    • \n
  • \n
      \n
    • org.gicentre.handy.Simplifier
      • \n
    \n
    • \n
\n
\n
    \n
  • \n
    \n
    \n
    public class Simplifier\nextends java.lang.Object
    \n
    Performs Douglas-Peucker simplification on linear coordinate collections.
    \n
    \n
    Version:
    \n
    1.0, 3rd January, 2012.
    \n
    Author:
    \n
    Jo Wood, giCentre, City University London.
    \n
    \n
    • \n
\n
\n
\n
    \n
  • \n\n
      \n
    • \n\n\n

      Constructor Summary

      \n\n\n\n\n\n\n\n\n
      Constructors 
      Constructor and Description
      Simplifier() 
      \n
      • \n
    \n\n
      \n
    • \n\n\n

      Method Summary

      \n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
      All Methods Static Methods Concrete Methods 
      Modifier and TypeMethod and Description
      static float[]getSimplifiedX()\n
      Provides the simplified x coordinates.
      \n
      static float[]getSimplifiedY()\n
      Provides the simplified y coordinates.
      \n
      static voidsimplify(java.util.ArrayList<processing.core.PVector> origCoords,\n float tol)\n
      Creates a simplified version of the given collection of coordinates.
      \n
      \n
        \n
      • \n\n\n

        Methods inherited from class java.lang.Object

        \nclone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
        • \n
      \n
      • \n
    \n
    • \n
\n
\n
\n
    \n
  • \n\n
      \n
    • \n\n\n

      Constructor Detail

      \n\n\n\n
        \n
      • \n

        Simplifier

        \n
        public Simplifier()
        \n
        • \n
      \n
      • \n
    \n\n
      \n
    • \n\n\n

      Method Detail

      \n\n\n\n
        \n
      • \n

        simplify

        \n
        public static void simplify(java.util.ArrayList<processing.core.PVector> origCoords,\n                            float tol)
        \n
        Creates a simplified version of the given collection of coordinates. Uses Douglas-Peucker simplification\n using the given tolerance value. The greater the tolerance, the greater the simplification.
        \n
        \n
        Parameters:
        \n
        origCoords - Coordinates to be simplified.
        \n
        tol - Douglas-Peucker tolerance (in spatial units).
        \n
        \n
        • \n
      \n\n\n\n
        \n
      • \n

        getSimplifiedX

        \n
        public static float[] getSimplifiedX()
        \n
        Provides the simplified x coordinates. This should only be called after simplify().
        \n
        \n
        Returns:
        \n
        x coordinates of simplified line.
        \n
        \n
        • \n
      \n\n\n\n
        \n
      • \n

        getSimplifiedY

        \n
        public static float[] getSimplifiedY()
        \n
        Provides the simplified y coordinates. This should only be called after simplify().
        \n
        \n
        Returns:
        \n
        y coordinates of simplified line.
        \n
        \n
        • \n
      \n
      • \n
    \n
    • \n
\n
\n
\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n\n\n\n
\n\n
\n
\n
    \n
  • Summary: 
    • \n
  • Nested | 
    • \n
  • Field | 
    • \n
  • Constr | 
    • \n
  • Method
    • \n
\n\n
\n\n\n
\n\n\n\n" }, { "path": "Handy/reference/org/gicentre/handy/Version.html", "content": "\n\n\n\n\nVersion\n\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n\n\n\n
\n\n
\n
\n
    \n
  • Summary: 
    • \n
  • Nested | 
    • \n
  • Field | 
    • \n
  • Constr | 
    • \n
  • Method
    • \n
\n\n
\n\n\n
\n\n\n
\n
org.gicentre.handy
\n

Class Version

\n
\n
\n
    \n
  • java.lang.Object
    • \n
  • \n
      \n
    • org.gicentre.handy.Version
      • \n
    \n
    • \n
\n
\n
    \n
  • \n
    \n
    \n
    public class Version\nextends java.lang.Object
    \n
    Stores version information about the Handy sketchy drawing package.
    \n
    \n
    Version:
    \n
    2.0, 4th April, 2016.
    \n
    Author:
    \n
    Jo Wood, giCentre, City University London.
    \n
    \n
    • \n
\n
\n
\n
    \n
  • \n\n
      \n
    • \n\n\n

      Constructor Summary

      \n\n\n\n\n\n\n\n\n
      Constructors 
      Constructor and Description
      Version() 
      \n
      • \n
    \n\n
      \n
    • \n\n\n

      Method Summary

      \n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
      All Methods Static Methods Concrete Methods 
      Modifier and TypeMethod and Description
      static java.lang.StringgetText()\n
      Reports the current version of the handy package.
      \n
      static floatgetVersion()\n
      Reports the numeric version of the handy package.
      \n
      \n
        \n
      • \n\n\n

        Methods inherited from class java.lang.Object

        \nclone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
        • \n
      \n
      • \n
    \n
    • \n
\n
\n
\n
    \n
  • \n\n
      \n
    • \n\n\n

      Constructor Detail

      \n\n\n\n
        \n
      • \n

        Version

        \n
        public Version()
        \n
        • \n
      \n
      • \n
    \n\n
      \n
    • \n\n\n

      Method Detail

      \n\n\n\n
        \n
      • \n

        getText

        \n
        public static java.lang.String getText()
        \n
        Reports the current version of the handy package.
        \n
        \n
        Returns:
        \n
        Text describing the current version of this package.
        \n
        \n
        • \n
      \n\n\n\n
        \n
      • \n

        getVersion

        \n
        public static float getVersion()
        \n
        Reports the numeric version of the handy package.
        \n
        \n
        Returns:
        \n
        Number representing the current version of this package.
        \n
        \n
        • \n
      \n
      • \n
    \n
    • \n
\n
\n
\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n\n\n\n
\n\n
\n
\n
    \n
  • Summary: 
    • \n
  • Nested | 
    • \n
  • Field | 
    • \n
  • Constr | 
    • \n
  • Method
    • \n
\n\n
\n\n\n
\n\n\n\n" }, { "path": "Handy/reference/org/gicentre/handy/class-use/HandyPresets.html", "content": "\n\n\n\n\nUses of Class org.gicentre.handy.HandyPresets\n\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n
\n

Uses of Class
org.gicentre.handy.HandyPresets

\n
\n
No usage of org.gicentre.handy.HandyPresets
\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n\n\n" }, { "path": "Handy/reference/org/gicentre/handy/class-use/HandyRecorder.html", "content": "\n\n\n\n\nUses of Class org.gicentre.handy.HandyRecorder\n\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n
\n

Uses of Class
org.gicentre.handy.HandyRecorder

\n
\n
No usage of org.gicentre.handy.HandyRecorder
\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n\n\n" }, { "path": "Handy/reference/org/gicentre/handy/class-use/HandyRenderer.html", "content": "\n\n\n\n\nUses of Class org.gicentre.handy.HandyRenderer\n\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n
\n

Uses of Class
org.gicentre.handy.HandyRenderer

\n
\n
\n\n
\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n\n\n" }, { "path": "Handy/reference/org/gicentre/handy/class-use/Simplifier.html", "content": "\n\n\n\n\nUses of Class org.gicentre.handy.Simplifier\n\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n
\n

Uses of Class
org.gicentre.handy.Simplifier

\n
\n
No usage of org.gicentre.handy.Simplifier
\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n\n\n" }, { "path": "Handy/reference/org/gicentre/handy/class-use/Version.html", "content": "\n\n\n\n\nUses of Class org.gicentre.handy.Version\n\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n
\n

Uses of Class
org.gicentre.handy.Version

\n
\n
No usage of org.gicentre.handy.Version
\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n\n\n" }, { "path": "Handy/reference/org/gicentre/handy/package-frame.html", "content": "\n\n\n\n\norg.gicentre.handy\n\n\n\n\n\n

org.gicentre.handy

\n
\n

Classes

\n\n
\n\n\n" }, { "path": "Handy/reference/org/gicentre/handy/package-summary.html", "content": "\n\n\n\n\norg.gicentre.handy\n\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev Package
    • \n
  • Next Package
    • \n
\n\n\n
\n\n
\n\n\n
\n\n
\n

Package org.gicentre.handy

\n
\n
Main package for creating a handy renderer\n\n
\n
\n

See: Description

\n
\n
\n
    \n
  • \n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
    Class Summary 
    ClassDescription
    HandyPresets\n
    Set of static classes for creating preset handy styles, such as pencil sketch, ink and\n watercolour, 'Sharpie' style etc.
    \n
    HandyRecorder\n
    A PGraphics class for rendering in a sketchy style.
    \n
    HandyRenderer\n
    The renderer that draws graphic primitives in a sketchy style.
    \n
    Simplifier\n
    Performs Douglas-Peucker simplification on linear coordinate collections.
    \n
    Version\n
    Stores version information about the Handy sketchy drawing package.
    \n
    \n
    • \n
\n\n\n\n

Package org.gicentre.handy Description

\n
Main package for creating a handy renderer\n\n\n

\n This package includes the main classes for creating a handy renderer. Includes classes for producing\n rectangular hachures and for simplifying polylines.\n

\n\n\n

Related Documentation

\n\n\n\n\n\n
\n
Version 2.0, 4th April, 2016
\n
\n
\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev Package
    • \n
  • Next Package
    • \n
\n\n\n
\n\n
\n\n\n
\n\n\n\n" }, { "path": "Handy/reference/org/gicentre/handy/package-tree.html", "content": "\n\n\n\n\norg.gicentre.handy Class Hierarchy\n\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n
\n

Hierarchy For Package org.gicentre.handy

\n
\n
\n

Class Hierarchy

\n
    \n
  • java.lang.Object\n
      \n
    • org.gicentre.handy.HandyPresets
      • \n
    • org.gicentre.handy.HandyRenderer
      • \n
    • processing.core.PImage (implements java.lang.Cloneable, processing.core.PConstants)\n
        \n
      • processing.core.PGraphics (implements processing.core.PConstants)\n\n
        • \n
      \n
      • \n
    • org.gicentre.handy.Simplifier
      • \n
    • org.gicentre.handy.Version
      • \n
    \n
    • \n
\n
\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n\n\n" }, { "path": "Handy/reference/org/gicentre/handy/package-use.html", "content": "\n\n\n\n\nUses of Package org.gicentre.handy\n\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n
\n

Uses of Package
org.gicentre.handy

\n
\n
\n\n
\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n\n\n" }, { "path": "Handy/reference/overview-tree.html", "content": "\n\n\n\n\nClass Hierarchy\n\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n
\n

Hierarchy For All Packages

\nPackage Hierarchies:\n\n
\n
\n

Class Hierarchy

\n
    \n
  • java.lang.Object\n
      \n
    • org.gicentre.handy.HandyPresets
      • \n
    • org.gicentre.handy.HandyRenderer
      • \n
    • processing.core.PImage (implements java.lang.Cloneable, processing.core.PConstants)\n
        \n
      • processing.core.PGraphics (implements processing.core.PConstants)\n\n
        • \n
      \n
      • \n
    • org.gicentre.handy.Simplifier
      • \n
    • org.gicentre.handy.Version
      • \n
    \n
    • \n
\n
\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n\n\n" }, { "path": "Handy/reference/package-list", "content": "org.gicentre.handy\n" }, { "path": "Handy/reference/script.js", "content": "function show(type)\n{\n count = 0;\n for (var key in methods) {\n var row = document.getElementById(key);\n if ((methods[key] & type) != 0) {\n row.style.display = '';\n row.className = (count++ % 2) ? rowColor : altColor;\n }\n else\n row.style.display = 'none';\n }\n updateTabs(type);\n}\n\nfunction updateTabs(type)\n{\n for (var value in tabs) {\n var sNode = document.getElementById(tabs[value][0]);\n var spanNode = sNode.firstChild;\n if (value == type) {\n sNode.className = activeTableTab;\n spanNode.innerHTML = tabs[value][1];\n }\n else {\n sNode.className = tableTab;\n spanNode.innerHTML = \"\" + tabs[value][1] + \"\";\n }\n }\n}\n" }, { "path": "Handy/reference/stylesheet.css", "content": "/* Javadoc style sheet */\n/*\nOverall document style\n*/\n\n@import url('resources/fonts/dejavu.css');\n\nbody {\n background-color:#ffffff;\n color:#353833;\n font-family:'DejaVu Sans', Arial, Helvetica, sans-serif;\n font-size:14px;\n margin:0;\n}\na:link, a:visited {\n text-decoration:none;\n color:#4A6782;\n}\na:hover, a:focus {\n text-decoration:none;\n color:#bb7a2a;\n}\na:active {\n text-decoration:none;\n color:#4A6782;\n}\na[name] {\n color:#353833;\n}\na[name]:hover {\n text-decoration:none;\n color:#353833;\n}\npre {\n font-family:'DejaVu Sans Mono', monospace;\n font-size:14px;\n}\nh1 {\n font-size:20px;\n}\nh2 {\n font-size:18px;\n}\nh3 {\n font-size:16px;\n font-style:italic;\n}\nh4 {\n font-size:13px;\n}\nh5 {\n font-size:12px;\n}\nh6 {\n font-size:11px;\n}\nul {\n list-style-type:disc;\n}\ncode, tt {\n font-family:'DejaVu Sans Mono', monospace;\n font-size:14px;\n padding-top:4px;\n margin-top:8px;\n line-height:1.4em;\n}\ndt code {\n font-family:'DejaVu Sans Mono', monospace;\n font-size:14px;\n padding-top:4px;\n}\ntable tr td dt code {\n font-family:'DejaVu Sans Mono', monospace;\n font-size:14px;\n vertical-align:top;\n padding-top:4px;\n}\nsup {\n font-size:8px;\n}\n/*\nDocument title and Copyright styles\n*/\n.clear {\n clear:both;\n height:0px;\n overflow:hidden;\n}\n.aboutLanguage {\n float:right;\n padding:0px 21px;\n font-size:11px;\n z-index:200;\n margin-top:-9px;\n}\n.legalCopy {\n margin-left:.5em;\n}\n.bar a, .bar a:link, .bar a:visited, .bar a:active {\n color:#FFFFFF;\n text-decoration:none;\n}\n.bar a:hover, .bar a:focus {\n color:#bb7a2a;\n}\n.tab {\n background-color:#0066FF;\n color:#ffffff;\n padding:8px;\n width:5em;\n font-weight:bold;\n}\n/*\nNavigation bar styles\n*/\n.bar {\n background-color:#4D7A97;\n color:#FFFFFF;\n padding:.8em .5em .4em .8em;\n height:auto;/*height:1.8em;*/\n font-size:11px;\n margin:0;\n}\n.topNav {\n background-color:#4D7A97;\n color:#FFFFFF;\n float:left;\n padding:0;\n width:100%;\n clear:right;\n height:2.8em;\n padding-top:10px;\n overflow:hidden;\n font-size:12px; \n}\n.bottomNav {\n margin-top:10px;\n background-color:#4D7A97;\n color:#FFFFFF;\n float:left;\n padding:0;\n width:100%;\n clear:right;\n height:2.8em;\n padding-top:10px;\n overflow:hidden;\n font-size:12px;\n}\n.subNav {\n background-color:#dee3e9;\n float:left;\n width:100%;\n overflow:hidden;\n font-size:12px;\n}\n.subNav div {\n clear:left;\n float:left;\n padding:0 0 5px 6px;\n text-transform:uppercase;\n}\nul.navList, ul.subNavList {\n float:left;\n margin:0 25px 0 0;\n padding:0;\n}\nul.navList li{\n list-style:none;\n float:left;\n padding: 5px 6px;\n text-transform:uppercase;\n}\nul.subNavList li{\n list-style:none;\n float:left;\n}\n.topNav a:link, .topNav a:active, .topNav a:visited, .bottomNav a:link, .bottomNav a:active, .bottomNav a:visited {\n color:#FFFFFF;\n text-decoration:none;\n text-transform:uppercase;\n}\n.topNav a:hover, .bottomNav a:hover {\n text-decoration:none;\n color:#bb7a2a;\n text-transform:uppercase;\n}\n.navBarCell1Rev {\n background-color:#F8981D;\n color:#253441;\n margin: auto 5px;\n}\n.skipNav {\n position:absolute;\n top:auto;\n left:-9999px;\n overflow:hidden;\n}\n/*\nPage header and footer styles\n*/\n.header, .footer {\n clear:both;\n margin:0 20px;\n padding:5px 0 0 0;\n}\n.indexHeader {\n margin:10px;\n position:relative;\n}\n.indexHeader span{\n margin-right:15px;\n}\n.indexHeader h1 {\n font-size:13px;\n}\n.title {\n color:#2c4557;\n margin:10px 0;\n}\n.subTitle {\n margin:5px 0 0 0;\n}\n.header ul {\n margin:0 0 15px 0;\n padding:0;\n}\n.footer ul {\n margin:20px 0 5px 0;\n}\n.header ul li, .footer ul li {\n list-style:none;\n font-size:13px;\n}\n/*\nHeading styles\n*/\ndiv.details ul.blockList ul.blockList ul.blockList li.blockList h4, div.details ul.blockList ul.blockList ul.blockListLast li.blockList h4 {\n background-color:#dee3e9;\n border:1px solid #d0d9e0;\n margin:0 0 6px -8px;\n padding:7px 5px;\n}\nul.blockList ul.blockList ul.blockList li.blockList h3 {\n background-color:#dee3e9;\n border:1px solid #d0d9e0;\n margin:0 0 6px -8px;\n padding:7px 5px;\n}\nul.blockList ul.blockList li.blockList h3 {\n padding:0;\n margin:15px 0;\n}\nul.blockList li.blockList h2 {\n padding:0px 0 20px 0;\n}\n/*\nPage layout container styles\n*/\n.contentContainer, .sourceContainer, .classUseContainer, .serializedFormContainer, .constantValuesContainer {\n clear:both;\n padding:10px 20px;\n position:relative;\n}\n.indexContainer {\n margin:10px;\n position:relative;\n font-size:12px;\n}\n.indexContainer h2 {\n font-size:13px;\n padding:0 0 3px 0;\n}\n.indexContainer ul {\n margin:0;\n padding:0;\n}\n.indexContainer ul li {\n list-style:none;\n padding-top:2px;\n}\n.contentContainer .description dl dt, .contentContainer .details dl dt, .serializedFormContainer dl dt {\n font-size:12px;\n font-weight:bold;\n margin:10px 0 0 0;\n color:#4E4E4E;\n}\n.contentContainer .description dl dd, .contentContainer .details dl dd, .serializedFormContainer dl dd {\n margin:5px 0 10px 0px;\n font-size:14px;\n font-family:'DejaVu Sans Mono',monospace;\n}\n.serializedFormContainer dl.nameValue dt {\n margin-left:1px;\n font-size:1.1em;\n display:inline;\n font-weight:bold;\n}\n.serializedFormContainer dl.nameValue dd {\n margin:0 0 0 1px;\n font-size:1.1em;\n display:inline;\n}\n/*\nList styles\n*/\nul.horizontal li {\n display:inline;\n font-size:0.9em;\n}\nul.inheritance {\n margin:0;\n padding:0;\n}\nul.inheritance li {\n display:inline;\n list-style:none;\n}\nul.inheritance li ul.inheritance {\n margin-left:15px;\n padding-left:15px;\n padding-top:1px;\n}\nul.blockList, ul.blockListLast {\n margin:10px 0 10px 0;\n padding:0;\n}\nul.blockList li.blockList, ul.blockListLast li.blockList {\n list-style:none;\n margin-bottom:15px;\n line-height:1.4;\n}\nul.blockList ul.blockList li.blockList, ul.blockList ul.blockListLast li.blockList {\n padding:0px 20px 5px 10px;\n border:1px solid #ededed; \n background-color:#f8f8f8;\n}\nul.blockList ul.blockList ul.blockList li.blockList, ul.blockList ul.blockList ul.blockListLast li.blockList {\n padding:0 0 5px 8px;\n background-color:#ffffff;\n border:none;\n}\nul.blockList ul.blockList ul.blockList ul.blockList li.blockList {\n margin-left:0;\n padding-left:0;\n padding-bottom:15px;\n border:none;\n}\nul.blockList ul.blockList ul.blockList ul.blockList li.blockListLast {\n list-style:none;\n border-bottom:none;\n padding-bottom:0;\n}\ntable tr td dl, table tr td dl dt, table tr td dl dd {\n margin-top:0;\n margin-bottom:1px;\n}\n/*\nTable styles\n*/\n.overviewSummary, .memberSummary, .typeSummary, .useSummary, .constantsSummary, .deprecatedSummary {\n width:100%;\n border-left:1px solid #EEE; \n border-right:1px solid #EEE; \n border-bottom:1px solid #EEE; \n}\n.overviewSummary, .memberSummary {\n padding:0px;\n}\n.overviewSummary caption, .memberSummary caption, .typeSummary caption,\n.useSummary caption, .constantsSummary caption, .deprecatedSummary caption {\n position:relative;\n text-align:left;\n background-repeat:no-repeat;\n color:#253441;\n font-weight:bold;\n clear:none;\n overflow:hidden;\n padding:0px;\n padding-top:10px;\n padding-left:1px;\n margin:0px;\n white-space:pre;\n}\n.overviewSummary caption a:link, .memberSummary caption a:link, .typeSummary caption a:link,\n.useSummary caption a:link, .constantsSummary caption a:link, .deprecatedSummary caption a:link,\n.overviewSummary caption a:hover, .memberSummary caption a:hover, .typeSummary caption a:hover,\n.useSummary caption a:hover, .constantsSummary caption a:hover, .deprecatedSummary caption a:hover,\n.overviewSummary caption a:active, .memberSummary caption a:active, .typeSummary caption a:active,\n.useSummary caption a:active, .constantsSummary caption a:active, .deprecatedSummary caption a:active,\n.overviewSummary caption a:visited, .memberSummary caption a:visited, .typeSummary caption a:visited,\n.useSummary caption a:visited, .constantsSummary caption a:visited, .deprecatedSummary caption a:visited {\n color:#FFFFFF;\n}\n.overviewSummary caption span, .memberSummary caption span, .typeSummary caption span,\n.useSummary caption span, .constantsSummary caption span, .deprecatedSummary caption span {\n white-space:nowrap;\n padding-top:5px;\n padding-left:12px;\n padding-right:12px;\n padding-bottom:7px;\n display:inline-block;\n float:left;\n background-color:#F8981D;\n border: none;\n height:16px;\n}\n.memberSummary caption span.activeTableTab span {\n white-space:nowrap;\n padding-top:5px;\n padding-left:12px;\n padding-right:12px;\n margin-right:3px;\n display:inline-block;\n float:left;\n background-color:#F8981D;\n height:16px;\n}\n.memberSummary caption span.tableTab span {\n white-space:nowrap;\n padding-top:5px;\n padding-left:12px;\n padding-right:12px;\n margin-right:3px;\n display:inline-block;\n float:left;\n background-color:#4D7A97;\n height:16px;\n}\n.memberSummary caption span.tableTab, .memberSummary caption span.activeTableTab {\n padding-top:0px;\n padding-left:0px;\n padding-right:0px;\n background-image:none;\n float:none;\n display:inline;\n}\n.overviewSummary .tabEnd, .memberSummary .tabEnd, .typeSummary .tabEnd,\n.useSummary .tabEnd, .constantsSummary .tabEnd, .deprecatedSummary .tabEnd {\n display:none;\n width:5px;\n position:relative;\n float:left;\n background-color:#F8981D;\n}\n.memberSummary .activeTableTab .tabEnd {\n display:none;\n width:5px;\n margin-right:3px;\n position:relative; \n float:left;\n background-color:#F8981D;\n}\n.memberSummary .tableTab .tabEnd {\n display:none;\n width:5px;\n margin-right:3px;\n position:relative;\n background-color:#4D7A97;\n float:left;\n\n}\n.overviewSummary td, .memberSummary td, .typeSummary td,\n.useSummary td, .constantsSummary td, .deprecatedSummary td {\n text-align:left;\n padding:0px 0px 12px 10px;\n width:100%;\n}\nth.colOne, th.colFirst, th.colLast, .useSummary th, .constantsSummary th,\ntd.colOne, td.colFirst, td.colLast, .useSummary td, .constantsSummary td{\n vertical-align:top;\n padding-right:0px;\n padding-top:8px;\n padding-bottom:3px;\n}\nth.colFirst, th.colLast, th.colOne, .constantsSummary th {\n background:#dee3e9;\n text-align:left;\n padding:8px 3px 3px 7px;\n}\ntd.colFirst, th.colFirst {\n white-space:nowrap;\n font-size:13px;\n}\ntd.colLast, th.colLast {\n font-size:13px;\n}\ntd.colOne, th.colOne {\n font-size:13px;\n}\n.overviewSummary td.colFirst, .overviewSummary th.colFirst,\n.overviewSummary td.colOne, .overviewSummary th.colOne,\n.memberSummary td.colFirst, .memberSummary th.colFirst,\n.memberSummary td.colOne, .memberSummary th.colOne,\n.typeSummary td.colFirst{\n width:25%;\n vertical-align:top;\n}\ntd.colOne a:link, td.colOne a:active, td.colOne a:visited, td.colOne a:hover, td.colFirst a:link, td.colFirst a:active, td.colFirst a:visited, td.colFirst a:hover, td.colLast a:link, td.colLast a:active, td.colLast a:visited, td.colLast a:hover, .constantValuesContainer td a:link, .constantValuesContainer td a:active, .constantValuesContainer td a:visited, .constantValuesContainer td a:hover {\n font-weight:bold;\n}\n.tableSubHeadingColor {\n background-color:#EEEEFF;\n}\n.altColor {\n background-color:#FFFFFF;\n}\n.rowColor {\n background-color:#EEEEEF;\n}\n/*\nContent styles\n*/\n.description pre {\n margin-top:0;\n}\n.deprecatedContent {\n margin:0;\n padding:10px 0;\n}\n.docSummary {\n padding:0;\n}\n\nul.blockList ul.blockList ul.blockList li.blockList h3 {\n font-style:normal;\n}\n\ndiv.block {\n font-size:14px;\n font-family:'DejaVu Serif', Georgia, \"Times New Roman\", Times, serif;\n}\n\ntd.colLast div {\n padding-top:0px;\n}\n\n\ntd.colLast a {\n padding-bottom:3px;\n}\n/*\nFormatting effect styles\n*/\n.sourceLineNo {\n color:green;\n padding:0 30px 0 0;\n}\nh1.hidden {\n visibility:hidden;\n overflow:hidden;\n font-size:10px;\n}\n.block {\n display:block;\n margin:3px 10px 2px 0px;\n color:#474747;\n}\n.deprecatedLabel, .descfrmTypeLabel, .memberNameLabel, .memberNameLink,\n.overrideSpecifyLabel, .packageHierarchyLabel, .paramLabel, .returnLabel,\n.seeLabel, .simpleTagLabel, .throwsLabel, .typeNameLabel, .typeNameLink {\n font-weight:bold;\n}\n.deprecationComment, .emphasizedPhrase, .interfaceName {\n font-style:italic;\n}\n\ndiv.block div.block span.deprecationComment, div.block div.block span.emphasizedPhrase,\ndiv.block div.block span.interfaceName {\n font-style:normal;\n}\n\ndiv.contentContainer ul.blockList li.blockList h2{\n padding-bottom:0px;\n}\n" }, { "path": "Handy/src/COPYING", "content": " GNU GENERAL PUBLIC LICENSE\n Version 3, 29 June 2007\n\n Copyright (C) 2007 Free Software Foundation, Inc. \n Everyone is permitted to copy and distribute verbatim copies\n of this license document, but changing it is not allowed.\n\n Preamble\n\n The GNU General Public License is a free, copyleft license for\nsoftware and other kinds of works.\n\n The licenses for most software and other practical works are designed\nto take away your freedom to share and change the works. By contrast,\nthe GNU General Public License is intended to guarantee your freedom to\nshare and change all versions of a program--to make sure it remains free\nsoftware for all its users. We, the Free Software Foundation, use the\nGNU General Public License for most of our software; it applies also to\nany other work released this way by its authors. You can apply it to\nyour programs, too.\n\n When we speak of free software, we are referring to freedom, not\nprice. Our General Public Licenses are designed to make sure that you\nhave the freedom to distribute copies of free software (and charge for\nthem if you wish), that you receive source code or can get it if you\nwant it, that you can change the software or use pieces of it in new\nfree programs, and that you know you can do these things.\n\n To protect your rights, we need to prevent others from denying you\nthese rights or asking you to surrender the rights. Therefore, you have\ncertain responsibilities if you distribute copies of the software, or if\nyou modify it: responsibilities to respect the freedom of others.\n\n For example, if you distribute copies of such a program, whether\ngratis or for a fee, you must pass on to the recipients the same\nfreedoms that you received. You must make sure that they, too, receive\nor can get the source code. And you must show them these terms so they\nknow their rights.\n\n Developers that use the GNU GPL protect your rights with two steps:\n(1) assert copyright on the software, and (2) offer you this License\ngiving you legal permission to copy, distribute and/or modify it.\n\n For the developers' and authors' protection, the GPL clearly explains\nthat there is no warranty for this free software. For both users' and\nauthors' sake, the GPL requires that modified versions be marked as\nchanged, so that their problems will not be attributed erroneously to\nauthors of previous versions.\n\n Some devices are designed to deny users access to install or run\nmodified versions of the software inside them, although the manufacturer\ncan do so. This is fundamentally incompatible with the aim of\nprotecting users' freedom to change the software. The systematic\npattern of such abuse occurs in the area of products for individuals to\nuse, which is precisely where it is most unacceptable. Therefore, we\nhave designed this version of the GPL to prohibit the practice for those\nproducts. If such problems arise substantially in other domains, we\nstand ready to extend this provision to those domains in future versions\nof the GPL, as needed to protect the freedom of users.\n\n Finally, every program is threatened constantly by software patents.\nStates should not allow patents to restrict development and use of\nsoftware on general-purpose computers, but in those that do, we wish to\navoid the special danger that patents applied to a free program could\nmake it effectively proprietary. To prevent this, the GPL assures that\npatents cannot be used to render the program non-free.\n\n The precise terms and conditions for copying, distribution and\nmodification follow.\n\n TERMS AND CONDITIONS\n\n 0. Definitions.\n\n \"This License\" refers to version 3 of the GNU General Public License.\n\n \"Copyright\" also means copyright-like laws that apply to other kinds of\nworks, such as semiconductor masks.\n\n \"The Program\" refers to any copyrightable work licensed under this\nLicense. Each licensee is addressed as \"you\". \"Licensees\" and\n\"recipients\" may be individuals or organizations.\n\n To \"modify\" a work means to copy from or adapt all or part of the work\nin a fashion requiring copyright permission, other than the making of an\nexact copy. The resulting work is called a \"modified version\" of the\nearlier work or a work \"based on\" the earlier work.\n\n A \"covered work\" means either the unmodified Program or a work based\non the Program.\n\n To \"propagate\" a work means to do anything with it that, without\npermission, would make you directly or secondarily liable for\ninfringement under applicable copyright law, except executing it on a\ncomputer or modifying a private copy. Propagation includes copying,\ndistribution (with or without modification), making available to the\npublic, and in some countries other activities as well.\n\n To \"convey\" a work means any kind of propagation that enables other\nparties to make or receive copies. Mere interaction with a user through\na computer network, with no transfer of a copy, is not conveying.\n\n An interactive user interface displays \"Appropriate Legal Notices\"\nto the extent that it includes a convenient and prominently visible\nfeature that (1) displays an appropriate copyright notice, and (2)\ntells the user that there is no warranty for the work (except to the\nextent that warranties are provided), that licensees may convey the\nwork under this License, and how to view a copy of this License. If\nthe interface presents a list of user commands or options, such as a\nmenu, a prominent item in the list meets this criterion.\n\n 1. Source Code.\n\n The \"source code\" for a work means the preferred form of the work\nfor making modifications to it. \"Object code\" means any non-source\nform of a work.\n\n A \"Standard Interface\" means an interface that either is an official\nstandard defined by a recognized standards body, or, in the case of\ninterfaces specified for a particular programming language, one that\nis widely used among developers working in that language.\n\n The \"System Libraries\" of an executable work include anything, other\nthan the work as a whole, that (a) is included in the normal form of\npackaging a Major Component, but which is not part of that Major\nComponent, and (b) serves only to enable use of the work with that\nMajor Component, or to implement a Standard Interface for which an\nimplementation is available to the public in source code form. A\n\"Major Component\", in this context, means a major essential component\n(kernel, window system, and so on) of the specific operating system\n(if any) on which the executable work runs, or a compiler used to\nproduce the work, or an object code interpreter used to run it.\n\n The \"Corresponding Source\" for a work in object code form means all\nthe source code needed to generate, install, and (for an executable\nwork) run the object code and to modify the work, including scripts to\ncontrol those activities. However, it does not include the work's\nSystem Libraries, or general-purpose tools or generally available free\nprograms which are used unmodified in performing those activities but\nwhich are not part of the work. For example, Corresponding Source\nincludes interface definition files associated with source files for\nthe work, and the source code for shared libraries and dynamically\nlinked subprograms that the work is specifically designed to require,\nsuch as by intimate data communication or control flow between those\nsubprograms and other parts of the work.\n\n The Corresponding Source need not include anything that users\ncan regenerate automatically from other parts of the Corresponding\nSource.\n\n The Corresponding Source for a work in source code form is that\nsame work.\n\n 2. Basic Permissions.\n\n All rights granted under this License are granted for the term of\ncopyright on the Program, and are irrevocable provided the stated\nconditions are met. This License explicitly affirms your unlimited\npermission to run the unmodified Program. The output from running a\ncovered work is covered by this License only if the output, given its\ncontent, constitutes a covered work. This License acknowledges your\nrights of fair use or other equivalent, as provided by copyright law.\n\n You may make, run and propagate covered works that you do not\nconvey, without conditions so long as your license otherwise remains\nin force. You may convey covered works to others for the sole purpose\nof having them make modifications exclusively for you, or provide you\nwith facilities for running those works, provided that you comply with\nthe terms of this License in conveying all material for which you do\nnot control copyright. Those thus making or running the covered works\nfor you must do so exclusively on your behalf, under your direction\nand control, on terms that prohibit them from making any copies of\nyour copyrighted material outside their relationship with you.\n\n Conveying under any other circumstances is permitted solely under\nthe conditions stated below. Sublicensing is not allowed; section 10\nmakes it unnecessary.\n\n 3. Protecting Users' Legal Rights From Anti-Circumvention Law.\n\n No covered work shall be deemed part of an effective technological\nmeasure under any applicable law fulfilling obligations under article\n11 of the WIPO copyright treaty adopted on 20 December 1996, or\nsimilar laws prohibiting or restricting circumvention of such\nmeasures.\n\n When you convey a covered work, you waive any legal power to forbid\ncircumvention of technological measures to the extent such circumvention\nis effected by exercising rights under this License with respect to\nthe covered work, and you disclaim any intention to limit operation or\nmodification of the work as a means of enforcing, against the work's\nusers, your or third parties' legal rights to forbid circumvention of\ntechnological measures.\n\n 4. Conveying Verbatim Copies.\n\n You may convey verbatim copies of the Program's source code as you\nreceive it, in any medium, provided that you conspicuously and\nappropriately publish on each copy an appropriate copyright notice;\nkeep intact all notices stating that this License and any\nnon-permissive terms added in accord with section 7 apply to the code;\nkeep intact all notices of the absence of any warranty; and give all\nrecipients a copy of this License along with the Program.\n\n You may charge any price or no price for each copy that you convey,\nand you may offer support or warranty protection for a fee.\n\n 5. Conveying Modified Source Versions.\n\n You may convey a work based on the Program, or the modifications to\nproduce it from the Program, in the form of source code under the\nterms of section 4, provided that you also meet all of these conditions:\n\n a) The work must carry prominent notices stating that you modified\n it, and giving a relevant date.\n\n b) The work must carry prominent notices stating that it is\n released under this License and any conditions added under section\n 7. This requirement modifies the requirement in section 4 to\n \"keep intact all notices\".\n\n c) You must license the entire work, as a whole, under this\n License to anyone who comes into possession of a copy. This\n License will therefore apply, along with any applicable section 7\n additional terms, to the whole of the work, and all its parts,\n regardless of how they are packaged. This License gives no\n permission to license the work in any other way, but it does not\n invalidate such permission if you have separately received it.\n\n d) If the work has interactive user interfaces, each must display\n Appropriate Legal Notices; however, if the Program has interactive\n interfaces that do not display Appropriate Legal Notices, your\n work need not make them do so.\n\n A compilation of a covered work with other separate and independent\nworks, which are not by their nature extensions of the covered work,\nand which are not combined with it such as to form a larger program,\nin or on a volume of a storage or distribution medium, is called an\n\"aggregate\" if the compilation and its resulting copyright are not\nused to limit the access or legal rights of the compilation's users\nbeyond what the individual works permit. Inclusion of a covered work\nin an aggregate does not cause this License to apply to the other\nparts of the aggregate.\n\n 6. Conveying Non-Source Forms.\n\n You may convey a covered work in object code form under the terms\nof sections 4 and 5, provided that you also convey the\nmachine-readable Corresponding Source under the terms of this License,\nin one of these ways:\n\n a) Convey the object code in, or embodied in, a physical product\n (including a physical distribution medium), accompanied by the\n Corresponding Source fixed on a durable physical medium\n customarily used for software interchange.\n\n b) Convey the object code in, or embodied in, a physical product\n (including a physical distribution medium), accompanied by a\n written offer, valid for at least three years and valid for as\n long as you offer spare parts or customer support for that product\n model, to give anyone who possesses the object code either (1) a\n copy of the Corresponding Source for all the software in the\n product that is covered by this License, on a durable physical\n medium customarily used for software interchange, for a price no\n more than your reasonable cost of physically performing this\n conveying of source, or (2) access to copy the\n Corresponding Source from a network server at no charge.\n\n c) Convey individual copies of the object code with a copy of the\n written offer to provide the Corresponding Source. This\n alternative is allowed only occasionally and noncommercially, and\n only if you received the object code with such an offer, in accord\n with subsection 6b.\n\n d) Convey the object code by offering access from a designated\n place (gratis or for a charge), and offer equivalent access to the\n Corresponding Source in the same way through the same place at no\n further charge. You need not require recipients to copy the\n Corresponding Source along with the object code. If the place to\n copy the object code is a network server, the Corresponding Source\n may be on a different server (operated by you or a third party)\n that supports equivalent copying facilities, provided you maintain\n clear directions next to the object code saying where to find the\n Corresponding Source. Regardless of what server hosts the\n Corresponding Source, you remain obligated to ensure that it is\n available for as long as needed to satisfy these requirements.\n\n e) Convey the object code using peer-to-peer transmission, provided\n you inform other peers where the object code and Corresponding\n Source of the work are being offered to the general public at no\n charge under subsection 6d.\n\n A separable portion of the object code, whose source code is excluded\nfrom the Corresponding Source as a System Library, need not be\nincluded in conveying the object code work.\n\n A \"User Product\" is either (1) a \"consumer product\", which means any\ntangible personal property which is normally used for personal, family,\nor household purposes, or (2) anything designed or sold for incorporation\ninto a dwelling. In determining whether a product is a consumer product,\ndoubtful cases shall be resolved in favor of coverage. For a particular\nproduct received by a particular user, \"normally used\" refers to a\ntypical or common use of that class of product, regardless of the status\nof the particular user or of the way in which the particular user\nactually uses, or expects or is expected to use, the product. A product\nis a consumer product regardless of whether the product has substantial\ncommercial, industrial or non-consumer uses, unless such uses represent\nthe only significant mode of use of the product.\n\n \"Installation Information\" for a User Product means any methods,\nprocedures, authorization keys, or other information required to install\nand execute modified versions of a covered work in that User Product from\na modified version of its Corresponding Source. The information must\nsuffice to ensure that the continued functioning of the modified object\ncode is in no case prevented or interfered with solely because\nmodification has been made.\n\n If you convey an object code work under this section in, or with, or\nspecifically for use in, a User Product, and the conveying occurs as\npart of a transaction in which the right of possession and use of the\nUser Product is transferred to the recipient in perpetuity or for a\nfixed term (regardless of how the transaction is characterized), the\nCorresponding Source conveyed under this section must be accompanied\nby the Installation Information. But this requirement does not apply\nif neither you nor any third party retains the ability to install\nmodified object code on the User Product (for example, the work has\nbeen installed in ROM).\n\n The requirement to provide Installation Information does not include a\nrequirement to continue to provide support service, warranty, or updates\nfor a work that has been modified or installed by the recipient, or for\nthe User Product in which it has been modified or installed. Access to a\nnetwork may be denied when the modification itself materially and\nadversely affects the operation of the network or violates the rules and\nprotocols for communication across the network.\n\n Corresponding Source conveyed, and Installation Information provided,\nin accord with this section must be in a format that is publicly\ndocumented (and with an implementation available to the public in\nsource code form), and must require no special password or key for\nunpacking, reading or copying.\n\n 7. Additional Terms.\n\n \"Additional permissions\" are terms that supplement the terms of this\nLicense by making exceptions from one or more of its conditions.\nAdditional permissions that are applicable to the entire Program shall\nbe treated as though they were included in this License, to the extent\nthat they are valid under applicable law. If additional permissions\napply only to part of the Program, that part may be used separately\nunder those permissions, but the entire Program remains governed by\nthis License without regard to the additional permissions.\n\n When you convey a copy of a covered work, you may at your option\nremove any additional permissions from that copy, or from any part of\nit. (Additional permissions may be written to require their own\nremoval in certain cases when you modify the work.) You may place\nadditional permissions on material, added by you to a covered work,\nfor which you have or can give appropriate copyright permission.\n\n Notwithstanding any other provision of this License, for material you\nadd to a covered work, you may (if authorized by the copyright holders of\nthat material) supplement the terms of this License with terms:\n\n a) Disclaiming warranty or limiting liability differently from the\n terms of sections 15 and 16 of this License; or\n\n b) Requiring preservation of specified reasonable legal notices or\n author attributions in that material or in the Appropriate Legal\n Notices displayed by works containing it; or\n\n c) Prohibiting misrepresentation of the origin of that material, or\n requiring that modified versions of such material be marked in\n reasonable ways as different from the original version; or\n\n d) Limiting the use for publicity purposes of names of licensors or\n authors of the material; or\n\n e) Declining to grant rights under trademark law for use of some\n trade names, trademarks, or service marks; or\n\n f) Requiring indemnification of licensors and authors of that\n material by anyone who conveys the material (or modified versions of\n it) with contractual assumptions of liability to the recipient, for\n any liability that these contractual assumptions directly impose on\n those licensors and authors.\n\n All other non-permissive additional terms are considered \"further\nrestrictions\" within the meaning of section 10. If the Program as you\nreceived it, or any part of it, contains a notice stating that it is\ngoverned by this License along with a term that is a further\nrestriction, you may remove that term. If a license document contains\na further restriction but permits relicensing or conveying under this\nLicense, you may add to a covered work material governed by the terms\nof that license document, provided that the further restriction does\nnot survive such relicensing or conveying.\n\n If you add terms to a covered work in accord with this section, you\nmust place, in the relevant source files, a statement of the\nadditional terms that apply to those files, or a notice indicating\nwhere to find the applicable terms.\n\n Additional terms, permissive or non-permissive, may be stated in the\nform of a separately written license, or stated as exceptions;\nthe above requirements apply either way.\n\n 8. Termination.\n\n You may not propagate or modify a covered work except as expressly\nprovided under this License. Any attempt otherwise to propagate or\nmodify it is void, and will automatically terminate your rights under\nthis License (including any patent licenses granted under the third\nparagraph of section 11).\n\n However, if you cease all violation of this License, then your\nlicense from a particular copyright holder is reinstated (a)\nprovisionally, unless and until the copyright holder explicitly and\nfinally terminates your license, and (b) permanently, if the copyright\nholder fails to notify you of the violation by some reasonable means\nprior to 60 days after the cessation.\n\n Moreover, your license from a particular copyright holder is\nreinstated permanently if the copyright holder notifies you of the\nviolation by some reasonable means, this is the first time you have\nreceived notice of violation of this License (for any work) from that\ncopyright holder, and you cure the violation prior to 30 days after\nyour receipt of the notice.\n\n Termination of your rights under this section does not terminate the\nlicenses of parties who have received copies or rights from you under\nthis License. If your rights have been terminated and not permanently\nreinstated, you do not qualify to receive new licenses for the same\nmaterial under section 10.\n\n 9. Acceptance Not Required for Having Copies.\n\n You are not required to accept this License in order to receive or\nrun a copy of the Program. Ancillary propagation of a covered work\noccurring solely as a consequence of using peer-to-peer transmission\nto receive a copy likewise does not require acceptance. However,\nnothing other than this License grants you permission to propagate or\nmodify any covered work. These actions infringe copyright if you do\nnot accept this License. Therefore, by modifying or propagating a\ncovered work, you indicate your acceptance of this License to do so.\n\n 10. Automatic Licensing of Downstream Recipients.\n\n Each time you convey a covered work, the recipient automatically\nreceives a license from the original licensors, to run, modify and\npropagate that work, subject to this License. You are not responsible\nfor enforcing compliance by third parties with this License.\n\n An \"entity transaction\" is a transaction transferring control of an\norganization, or substantially all assets of one, or subdividing an\norganization, or merging organizations. If propagation of a covered\nwork results from an entity transaction, each party to that\ntransaction who receives a copy of the work also receives whatever\nlicenses to the work the party's predecessor in interest had or could\ngive under the previous paragraph, plus a right to possession of the\nCorresponding Source of the work from the predecessor in interest, if\nthe predecessor has it or can get it with reasonable efforts.\n\n You may not impose any further restrictions on the exercise of the\nrights granted or affirmed under this License. For example, you may\nnot impose a license fee, royalty, or other charge for exercise of\nrights granted under this License, and you may not initiate litigation\n(including a cross-claim or counterclaim in a lawsuit) alleging that\nany patent claim is infringed by making, using, selling, offering for\nsale, or importing the Program or any portion of it.\n\n 11. Patents.\n\n A \"contributor\" is a copyright holder who authorizes use under this\nLicense of the Program or a work on which the Program is based. The\nwork thus licensed is called the contributor's \"contributor version\".\n\n A contributor's \"essential patent claims\" are all patent claims\nowned or controlled by the contributor, whether already acquired or\nhereafter acquired, that would be infringed by some manner, permitted\nby this License, of making, using, or selling its contributor version,\nbut do not include claims that would be infringed only as a\nconsequence of further modification of the contributor version. For\npurposes of this definition, \"control\" includes the right to grant\npatent sublicenses in a manner consistent with the requirements of\nthis License.\n\n Each contributor grants you a non-exclusive, worldwide, royalty-free\npatent license under the contributor's essential patent claims, to\nmake, use, sell, offer for sale, import and otherwise run, modify and\npropagate the contents of its contributor version.\n\n In the following three paragraphs, a \"patent license\" is any express\nagreement or commitment, however denominated, not to enforce a patent\n(such as an express permission to practice a patent or covenant not to\nsue for patent infringement). To \"grant\" such a patent license to a\nparty means to make such an agreement or commitment not to enforce a\npatent against the party.\n\n If you convey a covered work, knowingly relying on a patent license,\nand the Corresponding Source of the work is not available for anyone\nto copy, free of charge and under the terms of this License, through a\npublicly available network server or other readily accessible means,\nthen you must either (1) cause the Corresponding Source to be so\navailable, or (2) arrange to deprive yourself of the benefit of the\npatent license for this particular work, or (3) arrange, in a manner\nconsistent with the requirements of this License, to extend the patent\nlicense to downstream recipients. \"Knowingly relying\" means you have\nactual knowledge that, but for the patent license, your conveying the\ncovered work in a country, or your recipient's use of the covered work\nin a country, would infringe one or more identifiable patents in that\ncountry that you have reason to believe are valid.\n\n If, pursuant to or in connection with a single transaction or\narrangement, you convey, or propagate by procuring conveyance of, a\ncovered work, and grant a patent license to some of the parties\nreceiving the covered work authorizing them to use, propagate, modify\nor convey a specific copy of the covered work, then the patent license\nyou grant is automatically extended to all recipients of the covered\nwork and works based on it.\n\n A patent license is \"discriminatory\" if it does not include within\nthe scope of its coverage, prohibits the exercise of, or is\nconditioned on the non-exercise of one or more of the rights that are\nspecifically granted under this License. You may not convey a covered\nwork if you are a party to an arrangement with a third party that is\nin the business of distributing software, under which you make payment\nto the third party based on the extent of your activity of conveying\nthe work, and under which the third party grants, to any of the\nparties who would receive the covered work from you, a discriminatory\npatent license (a) in connection with copies of the covered work\nconveyed by you (or copies made from those copies), or (b) primarily\nfor and in connection with specific products or compilations that\ncontain the covered work, unless you entered into that arrangement,\nor that patent license was granted, prior to 28 March 2007.\n\n Nothing in this License shall be construed as excluding or limiting\nany implied license or other defenses to infringement that may\notherwise be available to you under applicable patent law.\n\n 12. No Surrender of Others' Freedom.\n\n If conditions are imposed on you (whether by court order, agreement or\notherwise) that contradict the conditions of this License, they do not\nexcuse you from the conditions of this License. If you cannot convey a\ncovered work so as to satisfy simultaneously your obligations under this\nLicense and any other pertinent obligations, then as a consequence you may\nnot convey it at all. For example, if you agree to terms that obligate you\nto collect a royalty for further conveying from those to whom you convey\nthe Program, the only way you could satisfy both those terms and this\nLicense would be to refrain entirely from conveying the Program.\n\n 13. Use with the GNU Affero General Public License.\n\n Notwithstanding any other provision of this License, you have\npermission to link or combine any covered work with a work licensed\nunder version 3 of the GNU Affero General Public License into a single\ncombined work, and to convey the resulting work. The terms of this\nLicense will continue to apply to the part which is the covered work,\nbut the special requirements of the GNU Affero General Public License,\nsection 13, concerning interaction through a network will apply to the\ncombination as such.\n\n 14. Revised Versions of this License.\n\n The Free Software Foundation may publish revised and/or new versions of\nthe GNU General Public License from time to time. Such new versions will\nbe similar in spirit to the present version, but may differ in detail to\naddress new problems or concerns.\n\n Each version is given a distinguishing version number. If the\nProgram specifies that a certain numbered version of the GNU General\nPublic License \"or any later version\" applies to it, you have the\noption of following the terms and conditions either of that numbered\nversion or of any later version published by the Free Software\nFoundation. If the Program does not specify a version number of the\nGNU General Public License, you may choose any version ever published\nby the Free Software Foundation.\n\n If the Program specifies that a proxy can decide which future\nversions of the GNU General Public License can be used, that proxy's\npublic statement of acceptance of a version permanently authorizes you\nto choose that version for the Program.\n\n Later license versions may give you additional or different\npermissions. However, no additional obligations are imposed on any\nauthor or copyright holder as a result of your choosing to follow a\nlater version.\n\n 15. Disclaimer of Warranty.\n\n THERE IS NO WARRANTY FOR THE PROGRAM, TO THE EXTENT PERMITTED BY\nAPPLICABLE LAW. EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT\nHOLDERS AND/OR OTHER PARTIES PROVIDE THE PROGRAM \"AS IS\" WITHOUT WARRANTY\nOF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO,\nTHE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR\nPURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE PROGRAM\nIS WITH YOU. SHOULD THE PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF\nALL NECESSARY SERVICING, REPAIR OR CORRECTION.\n\n 16. Limitation of Liability.\n\n IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING\nWILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MODIFIES AND/OR CONVEYS\nTHE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY\nGENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE\nUSE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED TO LOSS OF\nDATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD\nPARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER PROGRAMS),\nEVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF\nSUCH DAMAGES.\n\n 17. Interpretation of Sections 15 and 16.\n\n If the disclaimer of warranty and limitation of liability provided\nabove cannot be given local legal effect according to their terms,\nreviewing courts shall apply local law that most closely approximates\nan absolute waiver of all civil liability in connection with the\nProgram, unless a warranty or assumption of liability accompanies a\ncopy of the Program in return for a fee.\n\n END OF TERMS AND CONDITIONS\n\n How to Apply These Terms to Your New Programs\n\n If you develop a new program, and you want it to be of the greatest\npossible use to the public, the best way to achieve this is to make it\nfree software which everyone can redistribute and change under these terms.\n\n To do so, attach the following notices to the program. It is safest\nto attach them to the start of each source file to most effectively\nstate the exclusion of warranty; and each file should have at least\nthe \"copyright\" line and a pointer to where the full notice is found.\n\n \n Copyright (C) \n\n This program is free software: you can redistribute it and/or modify\n it under the terms of the GNU General Public License as published by\n the Free Software Foundation, either version 3 of the License, or\n (at your option) any later version.\n\n This program is distributed in the hope that it will be useful,\n but WITHOUT ANY WARRANTY; without even the implied warranty of\n MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the\n GNU General Public License for more details.\n\n You should have received a copy of the GNU General Public License\n along with this program. If not, see .\n\nAlso add information on how to contact you by electronic and paper mail.\n\n If the program does terminal interaction, make it output a short\nnotice like this when it starts in an interactive mode:\n\n Copyright (C) \n This program comes with ABSOLUTELY NO WARRANTY; for details type `show w'.\n This is free software, and you are welcome to redistribute it\n under certain conditions; type `show c' for details.\n\nThe hypothetical commands `show w' and `show c' should show the appropriate\nparts of the General Public License. Of course, your program's commands\nmight be different; for a GUI interface, you would use an \"about box\".\n\n You should also get your employer (if you work as a programmer) or school,\nif any, to sign a \"copyright disclaimer\" for the program, if necessary.\nFor more information on this, and how to apply and follow the GNU GPL, see\n.\n\n The GNU General Public License does not permit incorporating your program\ninto proprietary programs. If your program is a subroutine library, you\nmay consider it more useful to permit linking proprietary applications with\nthe library. If this is what you want to do, use the GNU Lesser General\nPublic License instead of this License. But first, please read\n." }, { "path": "Handy/src/COPYING.LESSER", "content": "\t\t GNU LESSER GENERAL PUBLIC LICENSE\n Version 3, 29 June 2007\n\n Copyright (C) 2007 Free Software Foundation, Inc. \n Everyone is permitted to copy and distribute verbatim copies\n of this license document, but changing it is not allowed.\n\n\n This version of the GNU Lesser General Public License incorporates\nthe terms and conditions of version 3 of the GNU General Public\nLicense, supplemented by the additional permissions listed below.\n\n 0. Additional Definitions.\n\n As used herein, \"this License\" refers to version 3 of the GNU Lesser\nGeneral Public License, and the \"GNU GPL\" refers to version 3 of the GNU\nGeneral Public License.\n\n \"The Library\" refers to a covered work governed by this License,\nother than an Application or a Combined Work as defined below.\n\n An \"Application\" is any work that makes use of an interface provided\nby the Library, but which is not otherwise based on the Library.\nDefining a subclass of a class defined by the Library is deemed a mode\nof using an interface provided by the Library.\n\n A \"Combined Work\" is a work produced by combining or linking an\nApplication with the Library. The particular version of the Library\nwith which the Combined Work was made is also called the \"Linked\nVersion\".\n\n The \"Minimal Corresponding Source\" for a Combined Work means the\nCorresponding Source for the Combined Work, excluding any source code\nfor portions of the Combined Work that, considered in isolation, are\nbased on the Application, and not on the Linked Version.\n\n The \"Corresponding Application Code\" for a Combined Work means the\nobject code and/or source code for the Application, including any data\nand utility programs needed for reproducing the Combined Work from the\nApplication, but excluding the System Libraries of the Combined Work.\n\n 1. Exception to Section 3 of the GNU GPL.\n\n You may convey a covered work under sections 3 and 4 of this License\nwithout being bound by section 3 of the GNU GPL.\n\n 2. Conveying Modified Versions.\n\n If you modify a copy of the Library, and, in your modifications, a\nfacility refers to a function or data to be supplied by an Application\nthat uses the facility (other than as an argument passed when the\nfacility is invoked), then you may convey a copy of the modified\nversion:\n\n a) under this License, provided that you make a good faith effort to\n ensure that, in the event an Application does not supply the\n function or data, the facility still operates, and performs\n whatever part of its purpose remains meaningful, or\n\n b) under the GNU GPL, with none of the additional permissions of\n this License applicable to that copy.\n\n 3. Object Code Incorporating Material from Library Header Files.\n\n The object code form of an Application may incorporate material from\na header file that is part of the Library. You may convey such object\ncode under terms of your choice, provided that, if the incorporated\nmaterial is not limited to numerical parameters, data structure\nlayouts and accessors, or small macros, inline functions and templates\n(ten or fewer lines in length), you do both of the following:\n\n a) Give prominent notice with each copy of the object code that the\n Library is used in it and that the Library and its use are\n covered by this License.\n\n b) Accompany the object code with a copy of the GNU GPL and this license\n document.\n\n 4. Combined Works.\n\n You may convey a Combined Work under terms of your choice that,\ntaken together, effectively do not restrict modification of the\nportions of the Library contained in the Combined Work and reverse\nengineering for debugging such modifications, if you also do each of\nthe following:\n\n a) Give prominent notice with each copy of the Combined Work that\n the Library is used in it and that the Library and its use are\n covered by this License.\n\n b) Accompany the Combined Work with a copy of the GNU GPL and this license\n document.\n\n c) For a Combined Work that displays copyright notices during\n execution, include the copyright notice for the Library among\n these notices, as well as a reference directing the user to the\n copies of the GNU GPL and this license document.\n\n d) Do one of the following:\n\n 0) Convey the Minimal Corresponding Source under the terms of this\n License, and the Corresponding Application Code in a form\n suitable for, and under terms that permit, the user to\n recombine or relink the Application with a modified version of\n the Linked Version to produce a modified Combined Work, in the\n manner specified by section 6 of the GNU GPL for conveying\n Corresponding Source.\n\n 1) Use a suitable shared library mechanism for linking with the\n Library. A suitable mechanism is one that (a) uses at run time\n a copy of the Library already present on the user's computer\n system, and (b) will operate properly with a modified version\n of the Library that is interface-compatible with the Linked\n Version.\n\n e) Provide Installation Information, but only if you would otherwise\n be required to provide such information under section 6 of the\n GNU GPL, and only to the extent that such information is\n necessary to install and execute a modified version of the\n Combined Work produced by recombining or relinking the\n Application with a modified version of the Linked Version. (If\n you use option 4d0, the Installation Information must accompany\n the Minimal Corresponding Source and Corresponding Application\n Code. If you use option 4d1, you must provide the Installation\n Information in the manner specified by section 6 of the GNU GPL\n for conveying Corresponding Source.)\n\n 5. Combined Libraries.\n\n You may place library facilities that are a work based on the\nLibrary side by side in a single library together with other library\nfacilities that are not Applications and are not covered by this\nLicense, and convey such a combined library under terms of your\nchoice, if you do both of the following:\n\n a) Accompany the combined library with a copy of the same work based\n on the Library, uncombined with any other library facilities,\n conveyed under the terms of this License.\n\n b) Give prominent notice with the combined library that part of it\n is a work based on the Library, and explaining where to find the\n accompanying uncombined form of the same work.\n\n 6. Revised Versions of the GNU Lesser General Public License.\n\n The Free Software Foundation may publish revised and/or new versions\nof the GNU Lesser General Public License from time to time. Such new\nversions will be similar in spirit to the present version, but may\ndiffer in detail to address new problems or concerns.\n\n Each version is given a distinguishing version number. If the\nLibrary as you received it specifies that a certain numbered version\nof the GNU Lesser General Public License \"or any later version\"\napplies to it, you have the option of following the terms and\nconditions either of that published version or of any later version\npublished by the Free Software Foundation. If the Library as you\nreceived it does not specify a version number of the GNU Lesser\nGeneral Public License, you may choose any version of the GNU Lesser\nGeneral Public License ever published by the Free Software Foundation.\n\n If the Library as you received it specifies that a proxy can decide\nwhether future versions of the GNU Lesser General Public License shall\napply, that proxy's public statement of acceptance of any version is\npermanent authorization for you to choose that version for the\nLibrary." }, { "path": "Handy/src/org/gicentre/handy/HachureIterator.java", "content": "package org.gicentre.handy;\n\n//*****************************************************************************************\n/** Provides a set of line coordinates that progress across a rectangular area at a given\n * angle.\n * @author Jo Wood, giCentre, City University London.\n * @version 1.0, 3rd January, 2012.\n */ \n// *****************************************************************************************\n\n/* This file is part of Handy sketchy drawing library. Handy is free software: you can \n * redistribute it and/or modify it under the terms of the GNU Lesser General Public License\n * as published by the Free Software Foundation, either version 3 of the License, or (at your\n * option) any later version.\n * \n * Handy is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY;\n * without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. \n * See the GNU Lesser General Public License for more details.\n * \n * You should have received a copy of the GNU Lesser General Public License along with this\n * source code (see COPYING.LESSER included with this source code). If not, see \n * http://www.gnu.org/licenses/.\n */\nclass HachureIterator \n{\n\t// -------------------------------- Object Variables ---------------------------------\n\t\n\tprivate float sinAngle,tanAngle;\n\tprivate float top,bottom,left, right;\n\tprivate float gap;\n\tprivate float pos;\n\tprivate float deltaX, hGap;\n\tprivate Segment sLeft,sRight;\n\t\n\t// ---------------------------------- Constructor ------------------------------------\n\t\n\t/** Creates an iterator that will provide a sequence of lines that fill the rectangular region provided.\n\t * @param top y-coordinate of top of rectangle.\n\t * @param bottom y-coordinate of bottom of rectangle.\n\t * @param left x-coordinate of left of rectangle.\n\t * @param right x-coordinate of right of rectangle.\n\t * @param gap Gap in pixel units between adjacent lines.\n\t * @param sinAngle Sine of the angle of the lines.\n\t * @param cosAngle Cosine of the angle of the lines.\n\t * @param tanAngle Tangent of the angle of the lines.\n\t */\n\tHachureIterator(float top, float bottom, float left, float right, float gap, float sinAngle, float cosAngle, float tanAngle)\n\t{\n\t\tthis.top = top;\n\t\tthis.bottom = bottom;\n\t\tthis.left = left;\n\t\tthis.right = right;\n\t\tthis.gap = gap;\n\t\tthis.sinAngle = sinAngle;\n\t\tthis.tanAngle = tanAngle;\n\t\t\n\t\tif (Math.abs(sinAngle) < 0.0001)\n\t\t{\n\t\t\t// Special case 1: Vertical lines\n\t\t\tpos = left+gap;\n\t\t}\n\t\telse if (Math.abs(sinAngle) > 0.9999)\n\t\t{\n\t\t\t// Special case 2: Horizontal lines\n\t\t\tpos = top+gap;\n\t\t}\n\t\telse\n\t\t{\n\t\t\tdeltaX = (bottom-top)*Math.abs(tanAngle);\n\t\t\tpos = left-Math.abs(deltaX);\n\t\t\thGap = Math.abs(gap /cosAngle);\n\t\t\tsLeft = new Segment(left,bottom,left,top);\n\t\t\tsRight = new Segment(right,bottom,right,top);\n\t\t}\t\t\n\t}\n\t\n\t/** Reports the next line that fits within the rectangle.\n\t * @return Coordinates of the line (x1,y1,x2,y2) or null if no more lines to find.\n\t */\n\tfloat[] getNextLine()\n\t{\n\t\tif (Math.abs(sinAngle) < 0.0001)\n\t\t{\n\t\t\t// Special case 1: Vertical hachuring\n\t\t\tif (pos < right)\n\t\t\t{\n\t\t\t\tfloat[] line = new float[] {pos,top,pos,bottom};\n\t\t\t\tpos += gap;\n\t\t\t\treturn line;\n\t\t\t}\n\t\t}\n\t\telse if (Math.abs(sinAngle) > 0.9999)\n\t\t{\n\t\t\t// Special case 2: Horizontal hachuring\n\t\t\tif (pos right) && (xUpper > right)))\n\t\t\t\t{\n\t\t\t\t\tpos += hGap;\n\t\t\t\t\txLower = pos-deltaX/2;\n\t\t\t\t\txUpper = pos+deltaX/2;\n\t\t\t\t\t\n\t\t\t\t\tif (pos > right+deltaX)\n\t\t\t\t\t{\n\t\t\t\t\t\treturn null;\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t\t\n\t\t\t\tSegment s = new Segment(xLower,yLower,xUpper,yUpper);\n\t\t\t\n\t\t\t\tif (s.compare(sLeft) == Segment.Relation.INTERSECTS)\n\t\t\t\t{\n\t\t\t\t\txLower = s.getIntersectionX();\n\t\t\t\t\tyLower = s.getIntersectionY();\n\t\t\t\t}\n\t\t\t\tif (s.compare(sRight) == Segment.Relation.INTERSECTS)\n\t\t\t\t{\n\t\t\t\t\txUpper = s.getIntersectionX();\n\t\t\t\t\tyUpper = s.getIntersectionY();\n\t\t\t\t}\n\t\t\t\tif (tanAngle > 0)\n\t\t\t\t{\n\t\t\t\t\txLower = right-(xLower-left);\n\t\t\t\t\txUpper = right-(xUpper-left);\n\t\t\t\t}\n\t\t\t\tfloat[] line = new float[] {xLower,yLower,xUpper,yUpper};\n\t\t\t\tpos += hGap;\n\t\t\t\treturn line;\n\t\t\t}\n\t\t}\n\t\t\n\t\t// If we get to this point, we must have finished all hachures\n\t\treturn null;\n\t}\n}\n" }, { "path": "Handy/src/org/gicentre/handy/HandyPresets.java", "content": "package org.gicentre.handy;\n\nimport processing.core.PApplet;\n\n// *****************************************************************************************\n/** Set of static classes for creating preset handy styles, such as pencil sketch, ink and\n * watercolour, 'Sharpie' style etc.\n * @author Jo Wood, giCentre, City University London.\n * @version 1.0, 23rd January, 2012.\n */ \n// *****************************************************************************************\n\n/* This file is part of Handy sketchy drawing library. Handy is free software: you can \n * redistribute it and/or modify it under the terms of the GNU Lesser General Public License\n * as published by the Free Software Foundation, either version 3 of the License, or (at your\n * option) any later version.\n * \n * Handy is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY;\n * without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. \n * See the GNU Lesser General Public License for more details.\n * \n * You should have received a copy of the GNU Lesser General Public License along with this\n * source code (see COPYING.LESSER included with this source code). If not, see \n * http://www.gnu.org/licenses/.\n */\n\npublic class HandyPresets\n{\n\t/** Prevents this class from being instantiated.\n\t */\n\tprivate HandyPresets()\n\t{\n\t\t// Do not allow instantiation of this class since it contains only static methods.\n\t}\n\t\t\n\t/** Creates a renderer that draws in a pencil sketch style.\n\t * @param parent PArent sketch that will do the drawing.\n\t * @return Renderer that draws in a pencil sketch style.\n\t */\n\tpublic static HandyRenderer createPencil(PApplet parent)\n\t{\n\t\tHandyRenderer handy = new HandyRenderer(parent);\n\t\t\n\t\thandy.setOverrideStrokeColour(true);\n\t\thandy.setStrokeColour(parent.color(120,180));\n\t\thandy.setOverrideFillColour(true);\n\t\thandy.setFillColour(parent.color(128,220));\n\t\thandy.setFillWeight(0.3f);\n\t\thandy.setFillGap(0.8f);\n\t\thandy.setUseSecondaryColour(true);\n\t\thandy.setBackgroundColour(parent.color(255,50));\n\t\thandy.setSecondaryColour(parent.color(255,100));\t\t\n\t\thandy.setHachurePerturbationAngle(5);\n\t\treturn handy;\n\t}\n\t\n\t/** Creates a renderer that draws in a coloured pencil sketch style.\n\t * @param parent PArent sketch that will do the drawing.\n\t * @return Renderer that draws in a coloured pencil sketch style.\n\t */\n\tpublic static HandyRenderer createColouredPencil(PApplet parent)\n\t{\n\t\tHandyRenderer handy = new HandyRenderer(parent);\n\t\thandy.setFillWeight(1.5f);\n\t\thandy.setFillGap(1f);\n\t\thandy.setStrokeColour(parent.color(255,0));\n\t\thandy.setOverrideStrokeColour(true);\n\t\t//handy.setBackgroundColour(parent.color(25,50));\n\t\thandy.setHachurePerturbationAngle(5);\n\t\treturn handy;\n\t}\n\t\n\t/** Creates a renderer that draws in a watercolour and ink style.\n\t * @param parent PArent sketch that will do the drawing.\n\t * @return Renderer that draws in a pencil sketch style.\n\t */\n\tpublic static HandyRenderer createWaterAndInk(PApplet parent)\n\t{\n\t\tHandyRenderer handy = new HandyRenderer(parent);\n\t\thandy.setOverrideStrokeColour(true);\n\t\thandy.setStrokeColour(parent.color(0));\n\t\thandy.setOverrideFillColour(false);\n\t\thandy.setFillGap(0);\n\t\thandy.setRoughness(3);\n\t\treturn handy;\n\t}\n\t\n\t/** Creates a renderer that draws in a felt-tip marker ('Sharpie') style.\n\t * @param parent PArent sketch that will do the drawing.\n\t * @return Renderer that draws in a marker style.\n\t */\n\tpublic static HandyRenderer createMarker(PApplet parent)\n\t{\n\t\tHandyRenderer handy = new HandyRenderer(parent);\n\t\thandy.setOverrideStrokeColour(true);\n\t\thandy.setStrokeColour(parent.color(0,160));\t\t\n\t\thandy.setFillWeight(5);\n\t\thandy.setStrokeWeight(3);\n\t\thandy.setFillGap(7);\n\t\thandy.setHachurePerturbationAngle(5);\n\t\thandy.setRoughness(1.5f);\n\t\treturn handy;\n\t}\n}" }, { "path": "Handy/src/org/gicentre/handy/HandyRecorder.java", "content": "package org.gicentre.handy;\n\nimport processing.core.PApplet;\nimport processing.core.PGraphics;\n\n// *****************************************************************************************\n/** A PGraphics class for rendering in a sketchy style. An object of this type can be passed\n * to a sketch's beginRecord(PGraphics) method. \n* @author Jo Wood, giCentre, City University London.\n* @version 2.0, 3rd April, 2016.\n*/ \n// *****************************************************************************************\n\n/* This file is part of Handy sketchy drawing library. Handy is free software: you can \n* redistribute it and/or modify it under the terms of the GNU Lesser General Public License\n* as published by the Free Software Foundation, either version 3 of the License, or (at your\n* option) any later version.\n* \n* Handy is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY;\n* without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. \n* See the GNU Lesser General Public License for more details.\n* \n* You should have received a copy of the GNU Lesser General Public License along with this\n* source code (see COPYING.LESSER included with this source code). If not, see \n* http://www.gnu.org/licenses/.\n*/\n\npublic class HandyRecorder extends PGraphics \n{\n\t// -------------------------------- Object Variables --------------------------------- \n\n\tprivate HandyRenderer h;\n\t\n\t// --------------------------------- Constructors ------------------------------------ \n\n\t/** Creates a new sketchy graphics context associated with the given parent sketch. This \n\t * version will create an internal handy renderer with default properties.\n\t * @param parentSketch Sketch with which this handy graphics object is to be associated.\n\t */\n\tpublic HandyRecorder(PApplet parentSketch)\n\t{\n\t\th = new HandyRenderer(parentSketch);\n\t}\n\t\n\t/** Creates a new sketchy graphics context associated with the given handy renderer. This\n\t * version allows the properties of the supplied handy renderer to be changed programmatically.\n\t * @param h Handy renderer to use when drawing to this graphics context.\n\t */\n\tpublic HandyRecorder(HandyRenderer h)\n\t{\n\t\tthis.h = h;\n\t}\n\t\n\t// ---------------------------- Overridden graphics methods -------------------------------------\n\t\n\t/** Draws 2D point at the given location. Currently this draws the point in the same style as the\n\t * default Processing renderer.\n\t * @param x x coordinate of the point.\n\t * @param y y coordinate of the point.\n\t */\n\t@Override\n\tpublic void point(float x, float y)\n\t{\n\t\tif (h.isHandy())\n\t\t{\n\t\t\th.point(x, y);\n\t\t}\n\t\telse\n\t\t{\n\t\t\tsuper.point(x, y);\n\t\t}\n\t}\n\n\t/** Draws 3D point at the given location. Currently this draws the point in the same style as the\n\t * default Processing renderer.\n\t * @param x x coordinate of the point.\n\t * @param y y coordinate of the point.\n\t * @param z z coordinate of the point.\n\t */\n\t@Override\n\tpublic void point(float x, float y, float z)\n\t{\n\t\tif (h.isHandy())\n\t\t{\n\t\t\th.point(x, y, z);\n\t\t}\n\t\telse\n\t\t{\n\t\t\tsuper.point(x, y, z);\n\t\t}\n\t}\n\n\t/** Draws an ellipse using the given location and dimensions. By default the x,y coordinates\n\t * will be centre of the ellipse, but the meanings of these parameters can be changed with\n\t * Processing's ellipseMode() command.\n\t * @param x x coordinate of the ellipse's position\n\t * @param y y coordinate of the ellipse's position.\n\t * @param eWidth Width of the ellipse (but see modifications possible with ellipseMode())\n\t * @param eHeight Height of the ellipse (but see modifications possible with ellipseMode())\n\t */\n\t@Override\n\tpublic void ellipse(float x, float y, float eWidth, float eHeight)\n\t{\n\t\tif (h.isHandy())\n\t\t{\n\t\t\th.ellipse(x, y, eWidth, eHeight);\n\t\t}\n\t\telse\n\t\t{\n\t\t\tsuper.ellipse(x, y, eWidth, eHeight);\n\t\t}\n\t}\n\n\t/** Draws a rectangle using the given location and dimensions. By default the x,y coordinates\n\t * will be the top left of the rectangle, but the meanings of these parameters can be \n\t * changed with Processing's rectMode() command.\n\t * @param x x coordinate of the rectangle position\n\t * @param y y coordinate of the rectangle position.\n\t * @param rWidth Width of the rectangle (but see modifications possible with rectMode())\n\t * @param rHeight Height of the rectangle (but see modifications possible with rectMode())\n\t */\n\t@Override\n\tpublic void rect(float x, float y, float rWidth, float rHeight)\n\t{\n\t\tif (h.isHandy())\n\t\t{\n\t\t\th.rect(x, y, rWidth, rHeight);\n\t\t}\n\t\telse\n\t\t{\n\t\t\tsuper.rect(x, y, rWidth, rHeight);\n\t\t}\n\t}\n\n\t/** Draws a triangle through the three pairs of coordinates.\n\t * @param x1 x coordinate of the first triangle vertex.\n\t * @param y1 y coordinate of the first triangle vertex.\n\t * @param x2 x coordinate of the second triangle vertex.\n\t * @param y2 y coordinate of the second triangle vertex.\n\t * @param x3 x coordinate of the third triangle vertex.\n\t * @param y3 y coordinate of the third triangle vertex.\n\t */\n\t@Override\n\tpublic void triangle(float x1, float y1, float x2, float y2, float x3, float y3)\n\t{\n\t\tif (h.isHandy())\n\t\t{\n\t\t\th.triangle(x1,y1,x2,y2,x3,y3);\n\t\t}\n\t\telse\n\t\t{\n\t\t\tsuper.triangle(x1, y1, x2, y2, x3, y3);\n\t\t}\n\t}\n\n\t/** Draws a quadrilateral shape. Similar to a rectangle but angles not constrained to 90 degrees.\n\t * Coordinates can proceed in either a clockwise or anti-clockwise direction.\n\t * @param x1 x coordinate of the first quadrilateral vertex.\n\t * @param y1 y coordinate of the first quadrilateral vertex.\n\t * @param x2 x coordinate of the second quadrilateral vertex.\n\t * @param y2 y coordinate of the second quadrilateral vertex.\n\t * @param x3 x coordinate of the third quadrilateral vertex.\n\t * @param y3 y coordinate of the third quadrilateral vertex.\n\t * @param x4 x coordinate of the fourth quadrilateral vertex.\n\t * @param y4 y coordinate of the fourth quadrilateral vertex.\n\t */\n\t@Override\n\tpublic void quad(float x1, float y1, float x2, float y2, float x3, float y3, float x4, float y4)\n\t{\n\t\tif (h.isHandy())\n\t\t{\n\t\t\th.quad(x1,y1,x2,y2,x3,y3,x4,y4);\n\t\t}\n\t\telse\n\t\t{\n\t\t\tsuper.quad(x1, y1, x2, y2, x3, y3, x4, y4);\n\t\t}\n\t}\n\n\t/** Draws an arc along the outer edge of an ellipse defined by the x,y, w and h parameters.\n\t * This version allows the maximum random offset of the arc to be set explicitly.\n\t * @param x x coordinate of the ellipse's position around which this arc is defined.\n\t * @param y y coordinate of the ellipse's position around which this arc is defined\n\t * @param aWidth Width of the ellipse around which this arc is defined (but see modifications possible with ellipseMode())\n\t * @param aHeight Height of the ellipse around which this arc is defined (but see modifications possible with ellipseMode())\n\t * @param start Angle to start the arc in radians.\n\t * @param stop Angle to stop the arc in radians.\n\t */\n\t@Override\n\tpublic void arc(float x, float y, float aWidth, float aHeight, float start, float stop)\n\t{\n\t\tif (h.isHandy())\n\t\t{\n\t\t\th.arc(x, y, aWidth, aHeight, start, stop);\n\t\t}\n\t\telse\n\t\t{\n\t\t\tsuper.arc(x, y, aWidth, aHeight, start, stop);\n\t\t}\n\t}\n\n\t/** Starts a new shape of type POLYGON. This must be paired with a call to \n\t * endShape() or one of its variants.\n\t */\n\t@Override\n\tpublic void beginShape()\n\t{\n\t\tif (h.isHandy())\n\t\t{\n\t\t\th.beginShape();\n\t\t}\n\t\telse\n\t\t{\n\t\t\tsuper.beginShape();\n\t\t}\n\t}\n\n\t/** Starts a new shape of the type specified in the mode parameter. This must be paired\n\t * with a call to endShape() or one of its variants.\n\t *\t@param mode either POINTS, LINES, TRIANGLES, TRIANGLE_FAN, TRIANGLE_STRIP, QUADS, QUAD_STRIP\t \n\t */\t\n\t@Override\n\tpublic void beginShape(int mode)\n\t{\n\t\tif (h.isHandy())\n\t\t{\n\t\t\th.beginShape(mode);\n\t\t}\n\t\telse\n\t\t{\n\t\t\tsuper.beginShape(mode);\n\t\t}\n\t}\n\n\t/** Adds a 2d vertex to a shape that was started with a call to beginShape() \n\t * or one of its variants.\n\t * @param x x coordinate of vertex to add.\n\t * @param y y coordinate of vertex to add.\n\t */\n\t@Override\n\tpublic void vertex(float x, float y)\n\t{\n\t\tif (h.isHandy())\n\t\t{\n\t\t\th.vertex(x, y);\n\t\t}\n\t\telse\n\t\t{\n\t\t\tsuper.vertex(x, y);\n\t\t}\n\t}\n\n\t/** Adds a 3d vertex to a shape that was started with a call to beginShape() \n\t * or one of its variants.\n\t * @param x x coordinate of vertex to add.\n\t * @param y y coordinate of vertex to add.\n\t * @param z z coordinate of vertex to add.\n\t */\n\t@Override\n\tpublic void vertex(float x, float y, float z)\n\t{\n\t\tif (h.isHandy())\n\t\t{\n\t\t\th.vertex(x, y, z);\n\t\t}\n\t\telse\n\t\t{\n\t\t\tsuper.vertex(x, y, z);\n\t\t}\n\t}\n\n\t/** Adds a 2d vertex to a shape or line that has curved edges. That shape should have been\n\t * started with a call to beginShape() without any parameter.\n\t * @param x x coordinate of vertex to add.\n\t * @param y y coordinate of vertex to add.\n\t */\n\t@Override\n\tpublic void curveVertex(float x, float y)\n\t{\n\t\tif (h.isHandy())\n\t\t{\n\t\t\th.curveVertex(x,y);\n\t\t}\n\t\telse\n\t\t{\n\t\t\tsuper.curveVertex(x,y);\n\t\t}\n\t}\n\n\t/** Adds a 3d vertex to a shape or line that has curved edges. That shape should have been\n\t * started with a call to beginShape() without any parameter.\n\t * @param x x coordinate of vertex to add.\n\t * @param y y coordinate of vertex to add.\n\t * @param z z coordinate of vertex to add.\n\t */\n\t@Override\n\tpublic void curveVertex(float x, float y, float z)\n\t{\n\t\tif (h.isHandy())\n\t\t{\n\t\t\th.curveVertex(x,y,z);\n\t\t}\n\t\telse\n\t\t{\n\t\t\tsuper.curveVertex(x, y, z);\n\t\t}\n\t}\n\n\t/** Ends a shape definition. This should have been paired with a call to beginShape()\n\t * or one of its variants. Note that this version will not close the shape if the last vertex does \n\t * not match the first one.\n\t */\n\t@Override\n\tpublic void endShape()\n\t{\n\t\tif (h.isHandy())\n\t\t{\n\t\t\th.endShape();\n\t\t}\n\t\telse\n\t\t{\n\t\t\tsuper.endShape();\n\t\t}\n\t}\n\n\t/** Ends a shape definition. This should have been paired with a call to beginShape() \n\t * or one of its variants. If the mode parameter CLOSE the shape will be closed.\n\t */\n\t@Override\n\tpublic void endShape(int mode) \n\t{\n\t\tif (h.isHandy())\n\t\t{\n\t\t\th.endShape(mode);\n\t\t}\n\t\telse\n\t\t{\n\t\t\tsuper.endShape(mode);\n\t\t}\n\t}\n\t\n\t/** Draws 3D cube with the given unit dimension.\n\t * @param bSize Size of each dimension of the cube.\n\t */\n\t@Override\n\tpublic void box(float bSize)\n\t{\n\t\tif (h.isHandy())\n\t\t{\n\t\t\th.box(bSize);\n\t\t}\n\t\telse\n\t\t{\n\t\t\tsuper.box(bSize);\n\t\t}\n\t}\n\n\t/** Draws 3D box with the given dimensions.\n\t * @param bWidth Width of the box.\n\t * @param bHeight Height of the box.\n\t * @param bDepth Depth of the box.\n\t */\n\t@Override\n\tpublic void box(float bWidth, float bHeight, float bDepth)\n\t{\n\t\tif (h.isHandy())\n\t\t{\n\t\t\th.box(bWidth, bHeight, bDepth);\n\t\t}\n\t\telse\n\t\t{\n\t\t\tsuper.box(bWidth, bHeight, bDepth);\n\t\t}\n\t}\n\n\t/** Draws a 2D line between the given coordinate pairs. \n\t * @param x1 x coordinate of the start of the line.\n\t * @param y1 y coordinate of the start of the line.\n\t * @param x2 x coordinate of the end of the line.\n\t * @param y2 y coordinate of the end of the line.\n\t */\n\t@Override\n\tpublic void line(float x1, float y1, float x2, float y2)\n\t{\t\n\t\tif (h.isHandy())\n\t\t{\n\t\t\th.line(x1,y1, x2,y2);\n\t\t}\n\t\telse\n\t\t{\n\t\t\tsuper.line(x1, y1, x2, y2);\n\t\t}\n\t}\n\n\t/** Draws a 3D line between the given coordinate triplets. \n\t * @param x1 x coordinate of the start of the line.\n\t * @param y1 y coordinate of the start of the line.\n\t * @param z1 z coordinate of the start of the line.\n\t * @param x2 x coordinate of the end of the line.\n\t * @param y2 y coordinate of the end of the line.\n\t * @param z2 z coordinate of the end of the line.\n\t */\n\t@Override\n\tpublic void line(float x1, float y1, float z1, float x2, float y2, float z2)\n\t{\t\n\t\tif (h.isHandy())\n\t\t{\n\t\t\th.line(x1, y1, z1, x2, y2, z2);\n\t\t}\n\t\telse\n\t\t{\n\t\t\tsuper.line(x1, y1, z1, x2, y2, z2);\n\t\t}\n\t}\n\n\t// ---------------- Methods not directly available in PGraphics requiring the parent sketch instead ----------------\n\t\n\t// These are mostly ignored as the default PGraphics equivalent reports an error message that they\n\t// are not available in the renderer. A HandyGraphics object is normally created in a PApplet\n\t// that does implement these methods, so there we just override to prevent the incorrect error message. \n\t\n\t/** Would translate the coordinate system by the given x and y values but ignored here as this will\n\t * be handled by the parent sketch.\n\t * @param x x value to translate by.\n\t * @param y y value to translate by.\n\t */\n\t@Override\n\tpublic void translate(float x, float y)\n\t{\t\n\t\t// Do nothing.\n\t}\n\t\n\t/** Would translate the coordinate system by the given x and y values but ignored here as this \n\t * will be handled by the parent sketch.\n\t * @param x x value to translate by.\n\t * @param y y value to translate by.\n\t * @param z z value to translate by.\n\t */\n\t@Override\n\tpublic void translate(float x, float y, float z)\n\t{\t\n\t\t// Do nothing.\n\t}\n\t\n\t/** Would scale the coordinate system in all directions but ignored here as this will be handled\n\t * by the parent sketch.\n\t * @param s value to scale all axes by.\n\t */\n\t@Override\n\tpublic void scale(float s)\n\t{\t\n\t\t// Do nothing.\n\t}\n\t\n\t/** Would scale the coordinate system by the given x and y values but ignored here as this will be\n\t * handled by the parent sketch.\n\t * @param sx x value to scale by.\n\t * @param sy y value to scale by.\n\t */\n\t@Override\n\tpublic void scale(float sx, float sy)\n\t{\t\n\t\t// Do nothing.\n\t}\n\t\n\t/** Would scale the coordinate system by the given x, y and z values but ignored here as this will be\n\t * handled by the parent sketch.\n\t * @param sx x value to scale by.\n\t * @param sy y value to scale by.\n\t * @param sz z value to scale by.\n\t */\n\t@Override\n\tpublic void scale(float sx, float sy, float sz)\n\t{\t\n\t\t// Do nothing.\n\t}\n\t\n\t/** Would rotate the coordinate system by the given angle but ignored here as this will be\n\t * handled by the parent sketch.\n\t * @param angle Angle by which to rotate the coordinate system (ignored).\n\t */\n\t@Override\n\tpublic void rotate(float angle)\n\t{\t\n\t\t// Do nothing.\n\t}\n\t\n\t/** Would rotate the coordinate system around the x-axis in 3d space but ignored here as this\n\t * will be handled by the parent sketch.\n\t * @param angle Angle by which to rotate around the x-axis (ignored).\n\t */\n\t@Override\n\tpublic void rotateX(float angle)\n\t{\t\n\t\t// Do nothing.\n\t}\n\t\n\t/** Would rotate the coordinate system around the y-axis in 3d space but ignored here as this\n\t * will be handled by the parent sketch.\n\t * @param angle Angle by which to rotate around the y-axis (ignored).\n\t */\n\t@Override\n\tpublic void rotateY(float angle)\n\t{\t\n\t\t// Do nothing.\n\t}\n\t\n\t/** Would rotate the coordinate system around the z-axis in 3d space but ignored here as this\n\t * will be handled by the parent sketch.\n\t * @param angle Angle by which to rotate around the z-axis (ignored).\n\t */\n\t@Override\n\tpublic void rotateZ(float angle)\n\t{\t\n\t\t// Do nothing.\n\t}\n\t\n\t/** Would rotate the coordinate system by the given angles but ignored here as this will be\n\t * handled by the parent sketch.\n\t * @param angle Angle of rotation (ignored).\n\t * @param x x component of vector around which to rotate (ignored)\n\t * @param y y component of vector around which to rotate (ignored)\n\t * @param z z component of vector around which to rotate (ignored)\n\t */\n\t@Override\n\tpublic void rotate(float angle, float x, float y, float z)\n\t{\t\n\t\t// Do nothing.\n\t}\n\t\n\t/** Would store a copy of the current transform matrix on the stack but ignored here as this\n\t * will be handled by the parent sketch. \n\t */\n\t@Override\n\tpublic void pushMatrix()\n\t{\t\n\t\t// Do nothing.\n\t}\n\t\n\t/** Would retrieve a copy of the current transform matrix from the stack but ignored here as this\n\t * will be handled by the parent sketch. \n\t */\n\t@Override\n\tpublic void popMatrix()\n\t{\t\n\t\t// Do nothing.\n\t}\n\t\n\t/** Would reset the current transform matrix to its default transform but ignored here as this\n\t * will be handled by the parent sketch.\n\t */\n\t@Override\n\tpublic void resetMatrix()\n\t{\t\n\t\t// Do nothing.\n\t}\n\t\n\t/** Would print the current transform matrix but ignored here as this will be handled by the parent sketch.\n\t */\n\t@Override\n\tpublic void printMatrix()\n\t{\t\n\t\t// Do nothing.\n\t}\n\t\n\t\n\t/** Would start 3d camera position definition but ignored here as this will be handled by the parent sketch.\n\t */\n\t@Override\n\tpublic void beginCamera()\n\t{\t\n\t\t// Do nothing.\n\t}\n\t\n\t/** Would allow the default 3d camera position to be set but ignored here as this will be handled by the parent sketch.\n\t */\n\t@Override\n\tpublic void camera()\n\t{\t\n\t\t// Do nothing.\n\t}\n\t\n\t/** Would end 3d camera position definition but ignored here as this will be handled by the parent sketch.\n\t */\n\t@Override\n\tpublic void endCamera()\n\t{\t\n\t\t// Do nothing.\n\t}\n\t\n\t/** Would allow the view frustum (clipping object) to be set but ignored here as this will be handled by the parent sketch.\n\t */\n\t@Override\n\tpublic void frustum(float left, float right, float bottom, float top, float near, float far)\n\t{\t\n\t\t// Do nothing.\n\t}\n\t\n\t/** Would apply the default perspective settings but ignored here as this will be handled by the parent sketch.\n\t */\n\t@Override\n\tpublic void perspective()\n\t{\t\n\t\t// Do nothing.\n\t}\n\t\n\t/** Would allow perspective settings to be changed but ignored here as this will be handled by the parent sketch.\n\t */\n\t@Override\n\tpublic void perspective(float fovy, float aspect, float zNear, float zFar)\n\t{\t\n\t\t// Do nothing.\n\t}\n\t\n\t/** Would set the blend mode for this graphics context but ignores it in this case as this will\n\t * be handled by the parent sketch.\n\t */\n\t@Override\n\tpublic void blendMode(int mode)\n\t{\t\n\t\t// Do nothing.\n\t}\n\t\n\t/** Would set the default 3d lighting for this graphics context but ignores it in this case as this will\n\t * be handled by the parent sketch.\n\t */\n\t@Override\n\tpublic void lights()\n\t{\t\n\t\t// Do nothing.\n\t}\n\t\n\t/** Would set a point light source for this graphics context but ignores it in this case as this will\n\t * be handled by the parent sketch.\n\t */\n\t@Override\n\tpublic void pointLight(float v1, float v2, float v3, float x, float y, float z)\n\t{\t\n\t\t// Do nothing.\n\t}\n\t\n\t/** Would set a ambient light source for this graphics context but ignores it in this case as this will\n\t * be handled by the parent sketch.\n\t */\n\t@Override\n\tpublic void ambientLight(float v1, float v2, float v3)\n\t{\t\n\t\t// Do nothing.\n\t}\n\t\n\t/** Would set a ambient light source for this graphics context but ignores it in this case as this will\n\t * be handled by the parent sketch.\n\t */\n\t@Override\n\tpublic void ambientLight(float v1, float v2, float v3, float x, float y, float z)\n\t{\t\n\t\t// Do nothing.\n\t}\n\t\n\t/** Would set a directional light source for this graphics context but ignores it in this case as this will\n\t * be handled by the parent sketch.\n\t */\n\t@Override\n\tpublic void directionalLight(float v1, float v2, float v3, float nx, float ny, float nz)\n\t{\t\n\t\t// Do nothing.\n\t}\n\t\n\t/** Would set a spotlight source for this graphics context but ignores it in this case as this will\n\t * be handled by the parent sketch.\n\t */\n\t@Override\n\tpublic void spotLight(float v1, float v2, float v3, float x, float y, float z, float nx, float ny, float nz, float angle, float concentration)\n\t{\t\n\t\t// Do nothing.\n\t}\n\t\n\t\n\t/** Would set a light falloff for point, spot and ambient light sources for this graphics context but ignores \n\t * it in this case as this will be handled by the parent sketch.\n\t */\n\t@Override\n\tpublic void lightFalloff(float constant, float linear, float quadratic)\n\t{\t\n\t\t// Do nothing.\n\t}\n\t\n\t/** Would set a specular colour for light sources in this graphics context but ignores \n\t * it in this case as this will be handled by the parent sketch.\n\t */\n\t@Override\n\tpublic void lightSpecular(float v1, float v2, float v3)\n\t{\t\n\t\t// Do nothing.\n\t}\n\t\n}\n" }, { "path": "Handy/src/org/gicentre/handy/HandyRenderer.java", "content": "package org.gicentre.handy;\n\nimport java.util.ArrayList;\nimport java.util.HashSet;\nimport java.util.List;\nimport java.util.Random;\nimport java.util.TreeMap;\n\nimport processing.core.PApplet;\nimport processing.core.PConstants;\nimport processing.core.PGraphics;\nimport processing.core.PVector;\n\n// *****************************************************************************************\n/** The renderer that draws graphic primitives in a sketchy style. The style of sketchiness\n * can be configured in this class. Based on an original idea by Nikolaus Gradwohl\n * @author Jo Wood, giCentre, City University London based on an idea by Nikolaus Gradwohl.\n * @version 2.0, 1st April, 2016.\n */ \n// *****************************************************************************************\n\n/* This file is part of Handy sketchy drawing library. Handy is free software: you can \n * redistribute it and/or modify it under the terms of the GNU Lesser General Public License\n * as published by the Free Software Foundation, either version 3 of the License, or (at your\n * option) any later version.\n * \n * Handy is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY;\n * without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. \n * See the GNU Lesser General Public License for more details.\n * \n * You should have received a copy of the GNU Lesser General Public License along with this\n * source code (see COPYING.LESSER included with this source code). If not, see \n * http://www.gnu.org/licenses/.\n */\n\npublic class HandyRenderer\n{\n\t// -------------------------------- Object Variables --------------------------------- \n\n\tprivate PApplet parent;\t\t\t\t\t\t// Parent class invoking the renderer.\n\tprivate PGraphics graphics;\t\t\t\t\t// Graphics context in which this class is to render.\n\tprivate Random rand;\t\t\t\t\t\t// Random number generator for random but repeatable offsets.\n\tprivate float cosAngle,sinAngle,tanAngle;\t// Lookups for quick calculations.\n\tprivate List vertices;\t\t\t\t// Temporary store of shape or polyline vertices.\n\tprivate HashSetcurveIndices;\t\t// Pointer to vertices that refer to curves\n\tprivate int shapeMode;\t\t\t\t\t\t// Type of setting for shape drawing.\n\tprivate boolean is3DShape;\t\t\t\t\t// Indicates if shape defined with vertices is 2d or 3d.\n\n\tprivate enum Plane2d {XY, XZ, YZ}\t\t\t// Used to identify plane onto which textures may be mapped for 3d faces.\n\n\t// Configuration settings\n\tprivate boolean isHandy;\t\t\t\t\t// Determines if normal or hand-drawn appearance is used.\n\tprivate int fillColour, strokeColour;\t\t// Main fill and stroke colours. \n\tprivate int bgColour, secondaryColour;\t\t// Background colour and secondary fill colour\t\n\tprivate boolean overrideFillColour;\t\t\t// Determines whether the fill colour is based on parent's fill colour or the setting in this class.\n\tprivate boolean overrideStrokeColour;\t\t// Determines whether the stroke colour is based on parent's stroke colour or the setting in this class.\n\tprivate boolean useSecondary;\t\t\t\t// Determines whether secondary colour is to be used.\n\tprivate boolean isAlternating;\t\t\t\t// Determines whether hachuring alternates in direction in continuous stroke.\n\tprivate float hachureAngle;\t\t\t\t\t// Angle of diagonal hachuring.\n\tprivate float anglePerturbation;\t\t\t// Random perturbation in hachure angle per object drawn.\n\tprivate float fillWeight, fillGap;\t\t\t// Hachure filling characteristics.\n\tprivate float strokeWeight;\t\t\t\t\t// Stroke weight for lines.\n\tprivate float roughness;\t\t\t\t\t// Scaling for random perturbations.\n\tprivate float bowing;\t\t\t\t\t\t// Scaling of the 'bowing' of lines at their midpoint.\n\n\tprivate int numEllipseSteps;\n\tprivate float ellipseInc;\t\t\t\t\t// Incremental steps along an ellipse.\n\n\tprivate static final float MIN_ROUGHNESS = 0.1f;\t// Roughess less than this value will be consisidered 0.\n\n\n\t// ----------------------------------- Constructor -----------------------------------\n\n\t/** Creates a new HandyRender capable of using standard Processing drawing commands\n\t * to render features in a sketchy hand-drawn style.\n\t * @param parent Parent sketch that will be drawn to.\n\t */\n\tpublic HandyRenderer(PApplet parent)\n\t{\n\t\tthis.parent = parent;\n\t\tthis.graphics = parent.g;\n\n\t\tnumEllipseSteps = 9;\n\t\tellipseInc = PConstants.TWO_PI/numEllipseSteps;\n\t\tvertices = new ArrayList();\n\t\tcurveIndices = new HashSet();\n\t\tis3DShape = false;\n\n\t\t// Set initial configuration options.\n\t\tsetIsHandy(true);\n\t\tresetStyles();\t\t\n\t}\n\n\t// ------------------------------------- Methods ------------------------------------- \n\n\t/** Sets the graphics context into which all output is directed. This method allows\n\t * output to be redirected to print output, offscreen buffers etc.\n\t * @param graphics New graphics context in which to render.\n\t */\n\tpublic void setGraphics(PGraphics graphics)\n\t{\n\t\tthis.graphics = graphics;\n\t}\n\n\t/** Copies the settings from one graphics context to another. This can be useful when creating an offscreen\n\t * buffer that needs to have the same appearance settings as the current context.\n\t * @param gSrc Source graphics context.\n\t * @param gDst Destination graphics context.\n\t */\n\tpublic static void copyGraphics(PGraphics gSrc, PGraphics gDst)\n\t{\n\t\tgDst.backgroundColor = gSrc.backgroundColor;\n\t\tgDst.bezierDetail = gSrc.bezierDetail;\n\t\tgDst.colorMode = gSrc.colorMode;\n\t\tgDst.curveDetail = gSrc.curveDetail;\n\t\tgDst.curveTightness = gSrc.curveTightness;\n\t\tgDst.ellipseMode = gSrc.ellipseMode;\n\t\tgDst.fill = gSrc.fill;\n\t\tgDst.fillColor = gSrc.fillColor;\n\t\tgDst.imageMode = gSrc.imageMode;\n\t\tgDst.pixelDensity = gSrc.pixelDensity;\n\t\tgDst.rectMode = gSrc.rectMode;\n\t\tgDst.shapeMode = gSrc.shapeMode;\n\t\tgDst.smooth = gSrc.smooth;\n\t\tgDst.stroke = gSrc.stroke;\n\t\tgDst.strokeCap = gSrc.strokeCap;\n\t\tgDst.strokeJoin = gSrc.strokeJoin;\n\t\tgDst.strokeColor = gSrc.strokeColor;\n\t\tgDst.strokeWeight = gSrc.strokeWeight;\t\n\t\tgDst.textAlign = gSrc.textAlign;\n\t\tgDst.textAlignY = gSrc.textAlignY;\n\t\tgDst.textFont = gSrc.textFont;\n\t\tgDst.textLeading = gSrc.textLeading;\n\t}\n\n\t/** Sets the seed used for random offsets when drawing. This should be called if repeated calls\n\t * to the same sketchy drawing methods should result in exactly the same rendering. If not called\n\t * a vibrating appearance can be given to the rendering.\n\t * @param seed Random number seed. This can be any whole number, generating the same random variation\n\t * in rendering on each redraw.\n\t */\n\tpublic void setSeed(long seed)\n\t{\n\t\trand.setSeed(seed);\n\t}\n\n\t// ----------------------------------- Configuration methods -----------------------------------\n\n\t/** Determines whether or not the renderer applies a hand-drawn sketchy appearance.\n\t * If false, normal Processing drawing is used; if true a sketchy appearance using \n\t * the current configuration style settings is used.\n\t * @param isHandy Sketchy appearance used if true, or normal Processing appearance if false.\n\t */\n\tpublic void setIsHandy(boolean isHandy)\n\t{\n\t\tthis.isHandy = isHandy;\n\t}\n\t\n\t/** Reports whether the renderer is currently set to draw in a sketchy style or not.\n\t * @return True if drawing in a sketchy style or false if not.\n\t */\n\tpublic boolean isHandy()\n\t{ \n\t\treturn isHandy;\n\t}\n\n\t/** Sets the angle for shading hachures.\n\t * @param degrees Angle of hachures in degrees where 0 is vertical, 45 is NE-SW and 90 is horizontal.\n\t */\n\tpublic void setHachureAngle(float degrees)\n\t{\n\t\thachureAngle = PApplet.radians(degrees%180);\n\t\tcosAngle = (float)Math.cos(hachureAngle);\n\t\tsinAngle = (float)Math.sin(hachureAngle);\n\t\ttanAngle = (float)Math.tan(hachureAngle);\n\t}\n\n\t/** Sets the maximum random perturbation in hachure angle per object. This allows a hachure angle to\n\t * vary between different shapes, but maintain approximate parallel hachure angle within a shape.\n\t * @param degrees Maximum hachure perturbation angle.\n\t */\n\tpublic void setHachurePerturbationAngle(float degrees)\n\t{\n\t\tthis.anglePerturbation = degrees;\n\t}\n\n\t/** Sets the background colour for closed shapes. \n\t * @param colour Background colour.\n\t */\n\tpublic void setBackgroundColour(int colour)\n\t{\n\t\tthis.bgColour = colour;\n\t}\n\n\t/** Sets the fill colour for closed shapes. Note this will only have an effect if\n\t * setOverrideFillColour() is true. \n\t * @param colour Fill colour to use.\n\t */\n\tpublic void setFillColour(int colour)\n\t{\n\t\tthis.fillColour = colour;\n\t}\n\n\t/** Determines whether or not to override the fill colour that would otherwise be determined by\n\t * the sketch's fillColor setting. If overridden, the colour is instead chosen from the \n\t * value last provided to setFillColour().\n\t * @param override If true the interior colour of features is determined by setFillColour,\n\t * if not, it is determined by the parent sketch's fill colour setting.\n\t */\n\tpublic void setOverrideFillColour(boolean override)\n\t{\n\t\tthis.overrideFillColour = override;\n\t}\n\n\t/** Sets the stroke colour for rendering features. Note this will only have an effect if\n\t * setOverrideStrokeColour() is true. \n\t * @param colour Stroke colour to use.\n\t */\n\tpublic void setStrokeColour(int colour)\n\t{\n\t\tthis.strokeColour = colour;\n\t}\n\n\t/** Determines whether or not to override the stroke colour that would otherwise be determined by\n\t * the sketch's strokeColor setting. If overridden, the colour is instead chosen from the \n\t * value last provided to setStrokeColour().\n\t * @param override If true the stroke colour of features is determined by setStrokeColour,\n\t * if not, it is determined by the parent sketch's stroke colour setting.\n\t */\n\tpublic void setOverrideStrokeColour(boolean override)\n\t{\n\t\tthis.overrideStrokeColour = override;\n\t}\n\n\t/** Determines whether or not a secondary colour is used for filling lines.\n\t * @param useSecondary If true a secondary colour is used.\n\t */\n\tpublic void setUseSecondaryColour(boolean useSecondary)\n\t{\n\t\tthis.useSecondary = useSecondary;\n\t}\n\n\t/** Sets the secondary colour for line filling. Note this will only have an effect if\n\t * setUseSecondaryColour() is true.\n\t * @param colour Colour to tint line filling.\n\t */\n\tpublic void setSecondaryColour(int colour)\n\t{\n\t\tthis.secondaryColour = colour;\n\t}\n\n\t/** Determines the thickness of fill lines. If zero or negative, the thickness is\n\t * proportional to the sketch's current strokeWeight.\n\t * @param weight Fill weight in pixel units. If zero or negative, fill weight is based on the sketch's strokeWeight setting. \n\t */\n\tpublic void setFillWeight(float weight)\n\t{\n\t\tthis.fillWeight = weight;\n\t}\n\n\t/** Determines the thickness of outer lines. If zero or negative, the thickness is\n\t * proportional to the sketch's current strokeWeight.\n\t * @param weight Stroke weight in pixel units. If zero or negative, stroke weight is based on the sketch's strokeWeight setting. \n\t */\n\tpublic void setStrokeWeight(float weight)\n\t{\n\t\tthis.strokeWeight = weight;\n\t}\n\n\t/** Determines the gap between fill lines. If zero, standard solid fill is used. If negative,\n\t * the gap is proportional to the sketch's current strokeWeight.\n\t * @param gap Gap between fill lines in pixel units. If zero, solid fill used; if negative, gap based on strokeWeight setting.\n\t */\n\tpublic void setFillGap(float gap)\n\t{\n\t\tthis.fillGap = gap;\n\t}\n\n\t/** Determines whether or not an alternating fill stroke is used to shade shapes. If true, shading appears\n\t * as one long zig-zag stroke rather than many approximately parallel lines.\n\t * @param alternate Zig-zag filling used if true, parallel lines if not.\n\t */\n\tpublic void setIsAlternating(boolean alternate)\n\t{\n\t\tthis.isAlternating = alternate;\n\t}\n\n\t/** Sets the general roughness of the sketch. 1 is a typically neat sketchiness, 0 is very precise, 5 \n\t * is very sketchy. Values are capped at 10.\n\t * @param roughness The sketchiness of the rendering. The larger the number the more sketchy the rendering.\n\t */\n\tpublic void setRoughness(float roughness)\n\t{\n\t\t// Cap roughness between 0 and 10.\n\t\tthis.roughness = Math.max(0,Math.min(roughness, 10));\n\t}\n\n\t/** Sets the amount of 'bowing' of lines (contols the degree to which a straigh line appears as an 'I' or 'C'). Applies to\n\t * all straight lines such as rectangle boundaries, hachuring and the segments of a polygon boundary. A value of 0 means \n\t * there is no systematic displacement away from the straight line path between the two endpoints in a line. A value of 1\n\t * gives a small random bowing, 10 an extremely bowed appearance. Note that bowing is independent of other random variations\n\t * in line geometry.Values are capped at 10.\n\t * @param bowing The degree of bowing in the rendering if straight lines. The larger the number the more 'loopy' lines appear.\n\t */\n\tpublic void setBowing(float bowing)\n\t{\n\t\t// Cap roughness between 0 and 10.\n\t\tthis.bowing = Math.max(0,Math.min(bowing, 10));\n\t}\n\n\t/** Resets the sketchy styles to default values.\n\t */\n\tpublic void resetStyles()\n\t{\n\t\tisAlternating = false;\n\t\tanglePerturbation = 0;\n\t\troughness = 1;\n\t\tbowing = 1;\n\t\trand = new Random(12345);\n\t\tsetStrokeColour(graphics.strokeColor);\n\t\tsetFillColour(graphics.fillColor);\n\t\tsetBackgroundColour(graphics.color(255));\n\t\tsetSecondaryColour(graphics.color(255));\n\t\tsetUseSecondaryColour(false);\n\t\tsetFillWeight(-1);\n\t\tsetStrokeWeight(-1);\n\t\tsetFillGap(-1);\n\t\tsetHachureAngle(-41);\n\t\tsetHachurePerturbationAngle(0);\n\t\tsetOverrideFillColour(false);\n\t\tsetOverrideStrokeColour(false);\n\t}\n\n\t// -------------------------------------- Drawing methods --------------------------------------\n\n\t/** Draws 2D point at the given location. Currently this draws the point in the same style as the\n\t * default Processing renderer.\n\t * @param x x coordinate of the point.\n\t * @param y y coordinate of the point.\n\t */\n\tpublic void point(float x, float y)\n\t{\n\t\tgraphics.point(x, y);\n\t}\n\n\t/** Draws 3D point at the given location. Currently this draws the point in the same style as the\n\t * default Processing renderer.\n\t * @param x x coordinate of the point.\n\t * @param y y coordinate of the point.\n\t * @param z z coordinate of the point.\n\t */\n\tpublic void point(float x, float y, float z)\n\t{\n\t\tgraphics.point(x, y, z);\n\t}\n\n\t/** Draws an ellipse using the given location and dimensions. By default the x,y coordinates\n\t * will be centre of the ellipse, but the meanings of these parameters can be changed with\n\t * Processing's ellipseMode() command.\n\t * @param x x coordinate of the ellipse's position\n\t * @param y y coordinate of the ellipse's position.\n\t * @param w Width of the ellipse (but see modifications possible with ellipseMode())\n\t * @param h Height of the ellipse (but see modifications possible with ellipseMode())\n\t */\n\tpublic void ellipse(float x, float y, float w, float h)\n\t{\n\t\tif (isHandy == false)\n\t\t{\n\t\t\tgraphics.ellipse(x,y,w,h);\n\t\t\treturn;\n\t\t}\n\n\t\tgraphics.pushStyle();\n\n\t\t// Default is to use 'CENTER' mode for defining ellipse\n\t\tfloat cx = x;\n\t\tfloat cy = y;\n\t\tfloat rx = Math.abs(w/2);\n\t\tfloat ry = Math.abs(h/2);\n\n\t\t// Adjust bounds for other ellipse modes.\n\t\tif (graphics.ellipseMode == PConstants.CORNER)\n\t\t{\n\t\t\tfloat left = Math.min(x,x+w);\n\t\t\tfloat top = Math.min(y,y+h);\n\t\t\tfloat right = Math.max(x,x+w);\n\t\t\tfloat bottom = Math.max(y,y+h);\n\t\t\trx = (right-left)/2;\n\t\t\try = (bottom-top)/2;\n\t\t\tcx = left + rx;\n\t\t\tcy = top + ry;\n\n\t\t}\n\t\tif (graphics.ellipseMode == PConstants.CORNERS)\n\t\t{\n\t\t\tfloat left = Math.min(x,w);\n\t\t\tfloat top = Math.min(y,h);\n\t\t\tfloat right = Math.max(x,w);\n\t\t\tfloat bottom = Math.max(y,h);\n\t\t\trx = (right-left)/2;\n\t\t\try = (bottom-top)/2;\n\t\t\tcx = left + rx;\n\t\t\tcy = top + ry;\n\t\t}\n\t\telse if (graphics.ellipseMode == PConstants.RADIUS)\n\t\t{\n\t\t\trx = Math.abs(w);\n\t\t\try = Math.abs(h);\n\t\t}\n\n\t\tif ((rx == 0) && (ry == 0))\n\t\t{\n\t\t\t// Never draw circles of radius 0.\n\t\t\treturn;\n\t\t}\n\n\t\tif ((rx < roughness/4) || (ry < roughness/4))\n\t\t{\n\t\t\t// Don't draw anything with a radius less than a quarter of the roughness value\n\t\t\treturn;\n\t\t}\t\n\n\t\t// Add small proportionate perturbation to dimensions of ellipse\n\t\trx += getOffset(-rx*0.05f, rx*0.05f);\n\t\try += getOffset(-ry*0.05f, ry*0.05f);\n\n\t\t// Store the original stroke and fill colours.\n\n\t\tint oStroke = graphics.strokeColor;\n\t\tint oFill = graphics.fillColor;\n\t\tfloat oWeight = graphics.strokeWeight;\n\t\tboolean oIsStroke = graphics.stroke;\n\t\tboolean oIsFill = graphics.fill;\n\t\tfloat originalAngle = PApplet.degrees(hachureAngle);\n\n\t\tif (oIsFill)\n\t\t{\n\t\t\t// Erase interior of ellipse if not completely transparent\n\t\t\tif ((fillGap != 0) && (graphics.alpha(bgColour) > 0))\n\t\t\t{\n\t\t\t\tint oEllipseMode = graphics.ellipseMode;\n\t\t\t\tgraphics.ellipseMode(PConstants.RADIUS);\n\t\t\t\tgraphics.noStroke();\n\t\t\t\tgraphics.fill(bgColour);\n\t\t\t\tgraphics.ellipse(cx,cy,rx,ry);\n\t\t\t\tgraphics.ellipseMode(oEllipseMode);\n\t\t\t\tgraphics.noFill();\n\t\t\t}\n\n\t\t\t// Only fill interior if the fill colour is distinct from the background.\n\t\t\tif (bgColour != (overrideFillColour?fillColour:oFill))\n\t\t\t{\n\t\t\t\tif (fillGap == 0)\n\t\t\t\t{\n\t\t\t\t\t// Fill with solid colour\n\t\t\t\t\tif (overrideFillColour)\n\t\t\t\t\t{\n\t\t\t\t\t\tgraphics.fill(fillColour);\n\t\t\t\t\t}\n\t\t\t\t\tint oEllipseMode = graphics.ellipseMode;\n\t\t\t\t\tgraphics.ellipseMode(PConstants.RADIUS);\n\t\t\t\t\tgraphics.noStroke();\n\t\t\t\t\tgraphics.ellipse(cx,cy,rx,ry);\n\t\t\t\t\tgraphics.ellipseMode(oEllipseMode);\n\t\t\t\t\tgraphics.noFill();\n\t\t\t\t}\n\t\t\t\telse\n\t\t\t\t{\n\t\t\t\t\t// We will be using strokes to fill, so change stroke to fill colour.\n\t\t\t\t\tif (overrideFillColour)\n\t\t\t\t\t{\n\t\t\t\t\t\tgraphics.stroke(fillColour);\n\t\t\t\t\t}\n\t\t\t\t\telse\n\t\t\t\t\t{\n\t\t\t\t\t\tgraphics.stroke(oFill);\n\t\t\t\t\t}\n\n\t\t\t\t\t// Perturb hachure angle if requested.\n\t\t\t\t\tif (anglePerturbation > 0)\n\t\t\t\t\t{\n\t\t\t\t\t\tsetHachureAngle(originalAngle + (2*rand.nextFloat()-1)*anglePerturbation);\n\t\t\t\t\t}\n\n\t\t\t\t\tif (fillWeight <=0)\n\t\t\t\t\t{\n\t\t\t\t\t\tgraphics.strokeWeight(oWeight/2f);\n\t\t\t\t\t}\n\t\t\t\t\telse\n\t\t\t\t\t{\n\t\t\t\t\t\tgraphics.strokeWeight(fillWeight);\n\t\t\t\t\t}\n\n\t\t\t\t\tdouble aspectRatio = ry/rx;\n\t\t\t\t\tdouble hyp = (float)Math.sqrt(aspectRatio*tanAngle*aspectRatio*tanAngle+1);\n\t\t\t\t\tdouble sinAnglePrime = aspectRatio*tanAngle / hyp;\n\t\t\t\t\tdouble cosAnglePrime = 1 / hyp;\n\n\t\t\t\t\tfloat gap = fillGap;\t// Gap between adjacent lines.\n\t\t\t\t\tif (gap < 0)\n\t\t\t\t\t{\n\t\t\t\t\t\tgap = oWeight*4;\t\t\t\t\t\n\t\t\t\t\t}\n\t\t\t\t\tif (isAlternating)\n\t\t\t\t\t{\n\t\t\t\t\t\t// If zig-zag filling, increase gap to give approximately similar density.\n\t\t\t\t\t\tgap *= 1.41f;\n\t\t\t\t\t}\n\t\t\t\t\tdouble gapPrime = gap/((rx*ry/Math.sqrt((ry*cosAnglePrime)*(ry*cosAnglePrime) + (rx*sinAnglePrime)*(rx*sinAnglePrime)))/rx);\n\t\t\t\t\tdouble halfLen = (float)Math.sqrt((rx*rx) - (cx-rx+gapPrime)*(cx-rx+gapPrime));\n\t\t\t\t\tfloat[] prevP2 = affine(cx-rx+gapPrime,cy+halfLen,cx,cy,sinAnglePrime,cosAnglePrime,aspectRatio);\n\n\t\t\t\t\tfor (double xPos=cx-rx+gapPrime; xPos 0)\n\t\t\t\t\t{\n\t\t\t\t\t\tsetHachureAngle(originalAngle);\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\n\t\t// Set stroke colour and weight.\n\t\tif ((oIsStroke) || (strokeWeight > 0))\n\t\t{\n\t\t\tif (overrideStrokeColour)\n\t\t\t{\n\t\t\t\tgraphics.stroke(strokeColour);\n\t\t\t}\n\t\t\telse\n\t\t\t{\n\t\t\t\tgraphics.stroke(oStroke);\t\n\t\t\t}\n\t\t\tif (strokeWeight > 0)\n\t\t\t{\n\t\t\t\tgraphics.strokeWeight(strokeWeight);\n\t\t\t}\n\t\t\telse\n\t\t\t{\n\t\t\t\tgraphics.strokeWeight(oWeight);\n\t\t\t}\n\t\t}\n\t\telse\n\t\t{\n\t\t\tgraphics.noStroke();\n\t\t}\n\n\t\t// Draw outline if requested\n\t\tif ((oIsStroke) || (overrideStrokeColour))\n\t\t{\n\t\t\tgraphics.noFill();\n\t\t\tif (roughness < MIN_ROUGHNESS)\n\t\t\t{\n\t\t\t\tgraphics.ellipse(cx,cy,2*rx,2*ry);\n\t\t\t\tgraphics.ellipse(cx,cy,2*rx,2*ry);\n\t\t\t}\n\t\t\telse\n\t\t\t{\n\t\t\t\tbuildEllipse(cx,cy,rx,ry,1,ellipseInc*getOffset(0.1f,getOffset(0.4f, 1f)));\n\t\t\t\tbuildEllipse(cx,cy,rx,ry,1.5f,0);\n\t\t\t}\n\t\t}\n\n\t\t// Restore original style settings.\n\t\tgraphics.popStyle();\n\t}\n\n\t/** Draws a rectangle using the given location and dimensions. By default the x,y coordinates\n\t * will be the top left of the rectangle, but the meanings of these parameters can be \n\t * changed with Processing's rectMode() command.\n\t * @param x x coordinate of the rectangle position\n\t * @param y y coordinate of the rectangle position.\n\t * @param w Width of the rectangle (but see modifications possible with rectMode())\n\t * @param h Height of the rectangle (but see modifications possible with rectMode())\n\t */\n\tpublic void rect(float x, float y, float w, float h)\n\t{\n\t\tif (isHandy == false)\n\t\t{\n\t\t\tgraphics.rect(x,y,w,h);\n\t\t\treturn;\n\t\t}\n\n\t\tgraphics.pushStyle();\n\t\t// Default is to use 'CORNER' mode for defining rectangle\n\t\tfloat left = Math.min(x,x+w);\n\t\tfloat top = Math.min(y,y+h);\n\t\tfloat right = Math.max(x,x+w);\n\t\tfloat bottom = Math.max(y,y+h);\n\n\t\t// Adjust bounds for other rectangle modes.\n\t\tif (graphics.rectMode == PConstants.CORNERS)\n\t\t{\n\t\t\tleft = Math.min(x,w);\n\t\t\ttop = Math.min(y,h);\n\t\t\tright = Math.max(x,w);\n\t\t\tbottom = Math.max(y,h);\n\t\t}\n\t\telse if (graphics.rectMode == PConstants.CENTER)\n\t\t{\n\t\t\tfloat halfWidth = w/2f;\n\t\t\tfloat halfHeight = h/2f;\n\n\t\t\tleft = Math.min(x-halfWidth,x+halfWidth);\n\t\t\tright = Math.max(x-halfWidth,x+halfWidth);\n\t\t\ttop = Math.min(y-halfHeight,y+halfHeight);\n\t\t\tbottom = Math.max(y-halfHeight,y+halfHeight);\n\t\t}\n\t\telse if (graphics.rectMode == PConstants.RADIUS)\n\t\t{\n\t\t\tleft = Math.min(x-w,x+w);\n\t\t\tright = Math.max(x-w,x+w);\n\t\t\ttop = Math.min(y-h,y+h);\n\t\t\tbottom = Math.max(y-h,y+h);\n\t\t}\n\n\t\t// Store the original stroke and fill colours.\n\t\tint oStroke = graphics.strokeColor;\n\t\tint oFill = graphics.fillColor;\n\t\tfloat oWeight = graphics.strokeWeight;\n\t\tboolean oIsStroke = graphics.stroke;\n\n\t\tif (graphics.fill)\n\t\t{\n\t\t\t// Erase interior of rectangle if background colour is not completely transparent.\n\t\t\tif ((fillGap != 0) && (graphics.alpha(bgColour) > 0))\n\t\t\t{\n\t\t\t\tint oRectMode = graphics.rectMode;\n\t\t\t\tgraphics.rectMode(PConstants.CORNERS);\n\t\t\t\tgraphics.fill(bgColour);\n\t\t\t\tgraphics.noStroke();\n\t\t\t\tgraphics.rect(left,top,right,bottom);\n\t\t\t\tgraphics.rectMode(oRectMode);\n\t\t\t\tgraphics.noFill();\n\t\t\t}\n\n\t\t\t// Only fill interior if the fill colour is distinct from the background.\n\t\t\tif (bgColour != (overrideFillColour?fillColour:oFill))\n\t\t\t{\n\t\t\t\tif (fillGap == 0)\n\t\t\t\t{\n\t\t\t\t\t// Fill with solid colour\n\t\t\t\t\tif (overrideFillColour)\n\t\t\t\t\t{\n\t\t\t\t\t\tgraphics.fill(fillColour);\n\t\t\t\t\t}\n\t\t\t\t\tint oRectMode = graphics.rectMode;\n\t\t\t\t\tgraphics.rectMode(PConstants.CORNERS);\n\t\t\t\t\tgraphics.noStroke();\n\t\t\t\t\tgraphics.rect(left,top,right,bottom);\n\t\t\t\t\tgraphics.rectMode(oRectMode);\n\t\t\t\t\tgraphics.noFill();\n\t\t\t\t}\n\t\t\t\telse\n\t\t\t\t{\n\t\t\t\t\t// We will be using strokes to fill, so change stroke to fill colour.\n\t\t\t\t\tif (overrideFillColour)\n\t\t\t\t\t{\n\t\t\t\t\t\tgraphics.stroke(fillColour);\n\t\t\t\t\t}\n\t\t\t\t\telse\n\t\t\t\t\t{\n\t\t\t\t\t\tgraphics.stroke(oFill);\n\t\t\t\t\t}\n\n\t\t\t\t\t// Perturb hachure angle if requested.\n\t\t\t\t\tfloat originalAngle = PApplet.degrees(hachureAngle);\n\t\t\t\t\tif (anglePerturbation > 0)\n\t\t\t\t\t{\n\t\t\t\t\t\tsetHachureAngle(originalAngle + (2*rand.nextFloat()-1)*anglePerturbation);\n\t\t\t\t\t}\n\n\t\t\t\t\tif (fillWeight <=0)\n\t\t\t\t\t{\n\t\t\t\t\t\tgraphics.strokeWeight(oWeight/2f);\n\t\t\t\t\t}\n\t\t\t\t\telse\n\t\t\t\t\t{\n\t\t\t\t\t\tgraphics.strokeWeight(fillWeight);\n\t\t\t\t\t}\n\n\t\t\t\t\tfloat gap = fillGap;\t// Gap between adjacent lines.\n\t\t\t\t\tif (gap < 0)\n\t\t\t\t\t{\n\t\t\t\t\t\tgap = oWeight*4;\t\t\t\t\t\n\t\t\t\t\t}\n\t\t\t\t\tif (isAlternating)\n\t\t\t\t\t{\n\t\t\t\t\t\t// If zig-zag filling, increase gap to give approximately similar density.\n\t\t\t\t\t\tgap *= 1.41f;\n\t\t\t\t\t}\n\n\t\t\t\t\tHachureIterator i = new HachureIterator(top, bottom, left, right, gap, sinAngle, cosAngle, tanAngle);\n\t\t\t\t\tfloat[] coords;\n\t\t\t\t\tfloat[] prevCoords = i.getNextLine();\n\n\t\t\t\t\tif (prevCoords != null)\n\t\t\t\t\t{\n\t\t\t\t\t\tline(prevCoords[0],prevCoords[1],prevCoords[2],prevCoords[3],2);\n\n\t\t\t\t\t\twhile ((coords=i.getNextLine()) != null)\n\t\t\t\t\t\t{\n\t\t\t\t\t\t\tif (isAlternating)\n\t\t\t\t\t\t\t{\n\t\t\t\t\t\t\t\tline(prevCoords[2],prevCoords[3],coords[0],coords[1],2);\n\t\t\t\t\t\t\t}\n\t\t\t\t\t\t\tline(coords[0],coords[1],coords[2],coords[3],2);\n\t\t\t\t\t\t\tprevCoords = coords;\n\t\t\t\t\t\t}\n\t\t\t\t\t}\n\n\t\t\t\t\t// Restore original hachure angle if requested.\n\t\t\t\t\tif (anglePerturbation > 0)\n\t\t\t\t\t{\n\t\t\t\t\t\tsetHachureAngle(originalAngle);\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t}\n\n\t\t\t// Set stroke colour and weight.\n\t\t\tif ((oIsStroke) || (strokeWeight > 0))\n\t\t\t{\n\t\t\t\tif (overrideStrokeColour)\n\t\t\t\t{\n\t\t\t\t\tgraphics.stroke(strokeColour);\n\t\t\t\t}\n\t\t\t\telse\n\t\t\t\t{\n\t\t\t\t\tgraphics.stroke(oStroke);\t\n\t\t\t\t}\n\n\t\t\t\tif (strokeWeight > 0)\n\t\t\t\t{\n\t\t\t\t\tgraphics.strokeWeight(strokeWeight);\n\t\t\t\t}\n\t\t\t\telse\n\t\t\t\t{\n\t\t\t\t\tgraphics.strokeWeight(oWeight);\n\t\t\t\t}\n\t\t\t}\n\t\t\telse\n\t\t\t{\n\t\t\t\tgraphics.noStroke();\n\t\t\t}\n\n\t\t\tgraphics.fill(oFill);\n\t\t}\n\n\t\t// Draw boundary of the rectangle.\n\t\tif ((oIsStroke) || (overrideStrokeColour))\n\t\t{\n\t\t\tline(left,top, right, top,2);\n\t\t\tline(right,top,right,bottom,2);\n\t\t\tline(right,bottom,left,bottom,2);\n\t\t\tline(left,bottom,left,top,2);\n\t\t}\n\n\t\t// Restore original style settings.\n\t\tgraphics.popStyle();\n\t}\n\n\t/** Draws a triangle through the three pairs of coordinates.\n\t * @param x1 x coordinate of the first triangle vertex.\n\t * @param y1 y coordinate of the first triangle vertex.\n\t * @param x2 x coordinate of the second triangle vertex.\n\t * @param y2 y coordinate of the second triangle vertex.\n\t * @param x3 x coordinate of the third triangle vertex.\n\t * @param y3 y coordinate of the third triangle vertex.\n\t */\n\tpublic void triangle(float x1, float y1, float x2, float y2, float x3, float y3)\n\t{\n\t\tif (isHandy == false)\n\t\t{\n\t\t\tgraphics.triangle(x1,y1,x2,y2,x3,y3);\n\t\t\treturn;\n\t\t}\n\t\tgraphics.pushStyle();\n\n\t\t// Bounding rectangle of the triangle.\n\t\tfloat left = Math.min(x1,Math.min(x2, x3));\n\t\tfloat right = Math.max(x1,Math.max(x2, x3));\n\t\tfloat top = Math.min(y1,Math.min(y2, y3));\n\t\tfloat bottom = Math.max(y1,Math.max(y2, y3));\n\n\t\t// Store the original stroke and fill colours.\n\t\tint oStroke = graphics.strokeColor;\n\t\tint oFill = graphics.fillColor;\n\t\tfloat oWeight = graphics.strokeWeight;\n\t\tboolean oIsStroke = graphics.stroke;\n\n\t\tif (graphics.fill)\n\t\t{\n\t\t\t// Erase interior of rectangle if background colour is not completely transparent.\n\t\t\tif ((fillGap != 0) && (graphics.alpha(bgColour) > 0))\n\t\t\t{\n\t\t\t\tgraphics.fill(bgColour);\n\t\t\t\tgraphics.noStroke();\n\t\t\t\tgraphics.triangle(x1,y1,x2,y2,x3,y3);\n\t\t\t\tgraphics.noFill();\n\t\t\t}\n\n\t\t\t// Only fill interior if the fill colour is distinct from the background.\n\t\t\tif (bgColour != (overrideFillColour?fillColour:oFill))\n\t\t\t{\n\t\t\t\tif (fillGap == 0)\n\t\t\t\t{\n\t\t\t\t\t// Fill with solid colour\n\t\t\t\t\tif (overrideFillColour)\n\t\t\t\t\t{\n\t\t\t\t\t\tgraphics.fill(fillColour);\n\t\t\t\t\t}\n\t\t\t\t\tgraphics.noStroke();\n\t\t\t\t\tgraphics.triangle(x1,y1,x2,y2,x3,y3);\n\t\t\t\t\tgraphics.noFill();\n\t\t\t\t}\n\t\t\t\telse\n\t\t\t\t{\n\t\t\t\t\t// We will be using strokes to fill, so change stroke to fill colour.\n\t\t\t\t\tif (overrideFillColour)\n\t\t\t\t\t{\n\t\t\t\t\t\tgraphics.stroke(fillColour);\n\t\t\t\t\t}\n\t\t\t\t\telse\n\t\t\t\t\t{\n\t\t\t\t\t\tgraphics.stroke(oFill);\n\t\t\t\t\t}\n\n\t\t\t\t\t// Perturb hachure angle if requested.\n\t\t\t\t\tfloat originalAngle = PApplet.degrees(hachureAngle);\n\t\t\t\t\tif (anglePerturbation > 0)\n\t\t\t\t\t{\n\t\t\t\t\t\tsetHachureAngle(originalAngle + (2*rand.nextFloat()-1)*anglePerturbation);\n\t\t\t\t\t}\n\n\t\t\t\t\tif (fillWeight <=0)\n\t\t\t\t\t{\n\t\t\t\t\t\tgraphics.strokeWeight(oWeight/2f);\n\t\t\t\t\t}\n\t\t\t\t\telse\n\t\t\t\t\t{\n\t\t\t\t\t\tgraphics.strokeWeight(fillWeight);\n\t\t\t\t\t}\n\n\t\t\t\t\tfloat gap = fillGap;\t// Gap between adjacent lines.\n\t\t\t\t\tif (gap < 0)\n\t\t\t\t\t{\n\t\t\t\t\t\tgap = oWeight*4;\t\t\t\t\t\n\t\t\t\t\t}\n\n\t\t\t\t\tif (isAlternating)\n\t\t\t\t\t{\n\t\t\t\t\t\t// If zig-zag filling, increase gap to give approximately similar density.\n\t\t\t\t\t\tgap *= 1.41f;\n\t\t\t\t\t}\n\n\t\t\t\t\tfloat[] prevCoords=null;\n\n\t\t\t\t\tHachureIterator i = new HachureIterator(top-1, bottom+1, left-1, right+1, gap, sinAngle, cosAngle, tanAngle);\n\t\t\t\t\tfloat[] rectCoords;\n\t\t\t\t\twhile ((rectCoords=i.getNextLine()) != null)\n\t\t\t\t\t{\n\t\t\t\t\t\t// line within rectangle can only intersect triangle two times at most.\n\t\t\t\t\t\tfloat[] triCoords = new float[4];\n\t\t\t\t\t\tint nextPoint = 0;\n\n\t\t\t\t\t\tSegment s = new Segment(rectCoords[0],rectCoords[1],rectCoords[2],rectCoords[3]);\n\t\t\t\t\t\tif (s.compare(new Segment(x1,y1,x2,y2)) == Segment.Relation.INTERSECTS)\n\t\t\t\t\t\t{\n\t\t\t\t\t\t\ttriCoords[nextPoint] = s.getIntersectionX();\n\t\t\t\t\t\t\ttriCoords[nextPoint+1] = s.getIntersectionY();\n\t\t\t\t\t\t\tnextPoint+=2;\n\t\t\t\t\t\t}\n\t\t\t\t\t\tif (s.compare(new Segment(x2,y2,x3,y3)) == Segment.Relation.INTERSECTS)\n\t\t\t\t\t\t{\n\t\t\t\t\t\t\ttriCoords[nextPoint] = s.getIntersectionX();\n\t\t\t\t\t\t\ttriCoords[nextPoint+1] = s.getIntersectionY();\n\t\t\t\t\t\t\tnextPoint+=2;\n\t\t\t\t\t\t}\n\t\t\t\t\t\tif ((nextPoint <=2) && (s.compare(new Segment(x3,y3,x1,y1)) == Segment.Relation.INTERSECTS))\n\t\t\t\t\t\t{\n\t\t\t\t\t\t\ttriCoords[nextPoint] = s.getIntersectionX();\n\t\t\t\t\t\t\ttriCoords[nextPoint+1] = s.getIntersectionY();\n\t\t\t\t\t\t\tnextPoint+=2;\n\t\t\t\t\t\t}\n\n\t\t\t\t\t\tif (nextPoint == 4)\n\t\t\t\t\t\t{\n\t\t\t\t\t\t\tif (isAlternating) \n\t\t\t\t\t\t\t{\n\t\t\t\t\t\t\t\t// Ensure coordinates are ordered consistently\n\t\t\t\t\t\t\t\tif (distSq(triCoords[0],triCoords[1],rectCoords[0],rectCoords[1]) > \n\t\t\t\t\t\t\t\tdistSq(triCoords[2],triCoords[3],rectCoords[0],rectCoords[1]))\n\t\t\t\t\t\t\t\t{\n\t\t\t\t\t\t\t\t\tfloat tempX = triCoords[2];\n\t\t\t\t\t\t\t\t\tfloat tempY = triCoords[3];\n\t\t\t\t\t\t\t\t\ttriCoords[2] = triCoords[0];\n\t\t\t\t\t\t\t\t\ttriCoords[3] = triCoords[1];\n\t\t\t\t\t\t\t\t\ttriCoords[0] = tempX;\n\t\t\t\t\t\t\t\t\ttriCoords[1] = tempY;\n\t\t\t\t\t\t\t\t}\n\n\t\t\t\t\t\t\t\tif (prevCoords != null)\n\t\t\t\t\t\t\t\t{\n\t\t\t\t\t\t\t\t\tline(prevCoords[0],prevCoords[1],triCoords[0],triCoords[1],2);\n\t\t\t\t\t\t\t\t}\n\t\t\t\t\t\t\t\tprevCoords = new float[] {triCoords[2],triCoords[3]};\n\t\t\t\t\t\t\t}\n\t\t\t\t\t\t\tline(triCoords[0],triCoords[1],triCoords[2],triCoords[3],2);\n\t\t\t\t\t\t}\n\t\t\t\t\t}\n\n\t\t\t\t\t// Restore original hachure angle if requested.\n\t\t\t\t\tif (anglePerturbation > 0)\n\t\t\t\t\t{\n\t\t\t\t\t\tsetHachureAngle(originalAngle);\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t}\n\n\t\t\t// Restore original fill settings.\n\t\t\tgraphics.fill(oFill);\n\t\t}\n\n\t\t// Draw boundary of the triangle.\n\t\tif ((oIsStroke) || (overrideStrokeColour))\n\t\t{\n\t\t\tif (overrideStrokeColour)\n\t\t\t{\n\t\t\t\tgraphics.stroke(strokeColour);\n\t\t\t}\n\t\t\telse\n\t\t\t{\n\t\t\t\tgraphics.stroke(oStroke);\t\n\t\t\t}\n\n\t\t\tif (strokeWeight > 0)\n\t\t\t{\n\t\t\t\tgraphics.strokeWeight(strokeWeight);\n\t\t\t}\n\t\t\telse\n\t\t\t{\n\t\t\t\tgraphics.strokeWeight(oWeight);\n\t\t\t}\n\t\t\tline(x1,y1, x2, y2,2);\n\t\t\tline(x2,y2, x3,y3,2);\n\t\t\tline(x3,y3, x1,y1,2);\n\t\t}\n\n\t\t// Restore original stroke settings.\n\t\tgraphics.popStyle();\n\t}\n\n\t/** Draws a quadrilateral shape. Similar to a rectangle but angles not constrained to 90 degrees.\n\t * Coordinates can proceed in either a clockwise or anti-clockwise direction.\n\t * @param x1 x coordinate of the first quadrilateral vertex.\n\t * @param y1 y coordinate of the first quadrilateral vertex.\n\t * @param x2 x coordinate of the second quadrilateral vertex.\n\t * @param y2 y coordinate of the second quadrilateral vertex.\n\t * @param x3 x coordinate of the third quadrilateral vertex.\n\t * @param y3 y coordinate of the third quadrilateral vertex.\n\t * @param x4 x coordinate of the fourth quadrilateral vertex.\n\t * @param y4 y coordinate of the fourth quadrilateral vertex.\n\t */\n\tpublic void quad(float x1, float y1, float x2, float y2, float x3, float y3, float x4, float y4)\n\t{\n\t\tshape(new float[] {x1,x2,x3,x4}, new float[] {y1,y2,y3,y4}, true);\n\t}\n\n\t/** Draws an arc along the outer edge of an ellipse defined by the x,y, w and h parameters.\n\t * This version allows the maximum random offset of the arc to be set explicitly.\n\t * @param x x coordinate of the ellipse's position around which this arc is defined.\n\t * @param y y coordinate of the ellipse's position around which this arc is defined\n\t * @param w Width of the ellipse around which this arc is defined (but see modifications possible with ellipseMode())\n\t * @param h Height of the ellipse around which this arc is defined (but see modifications possible with ellipseMode())\n\t * @param start Angle to start the arc in radians.\n\t * @param stop Angle to stop the arc in radians.\n\t */\n\tpublic void arc(float x, float y, float w, float h, float start, float stop)\n\t{\n\t\tif (isHandy == false)\n\t\t{\n\t\t\tgraphics.arc(x,y,w,h,start,stop);\n\t\t\treturn;\n\t\t}\n\n\t\t// Default is to use 'CENTER' mode for defining ellipse\n\t\tfloat cx = x;\n\t\tfloat cy = y;\n\t\tfloat rx = Math.abs(w/2);\n\t\tfloat ry = Math.abs(h/2);\n\n\t\t// Adjust bounds for other ellipse modes.\n\t\tif (graphics.ellipseMode == PConstants.CORNER)\n\t\t{\n\t\t\tfloat left = Math.min(x,x+w);\n\t\t\tfloat top = Math.min(y,y+h);\n\t\t\tfloat right = Math.max(x,x+w);\n\t\t\tfloat bottom = Math.max(y,y+h);\n\t\t\trx = (right-left)/2;\n\t\t\try = (bottom-top)/2;\n\t\t\tcx = left + rx;\n\t\t\tcy = top + ry;\n\n\t\t}\n\t\tif (graphics.ellipseMode == PConstants.CORNERS)\n\t\t{\n\t\t\tfloat left = Math.min(x,w);\n\t\t\tfloat top = Math.min(y,h);\n\t\t\tfloat right = Math.max(x,w);\n\t\t\tfloat bottom = Math.max(y,h);\n\t\t\trx = (right-left)/2;\n\t\t\try = (bottom-top)/2;\n\t\t\tcx = left + rx;\n\t\t\tcy = top + ry;\n\t\t}\n\t\telse if (graphics.ellipseMode == PConstants.RADIUS)\n\t\t{\n\t\t\trx = Math.abs(w);\n\t\t\try = Math.abs(h);\n\t\t}\n\n\t\tif ((rx == 0) && (ry == 0))\n\t\t{\n\t\t\t// Never draw circles of radius 0.\n\t\t\treturn;\n\t\t}\n\n\t\tif ((rx < roughness/4) || (ry < roughness/4))\n\t\t{\n\t\t\t// Don't draw anything with a radius less than a quarter of the roughness value\n\t\t\treturn;\n\t\t}\t\n\n\t\t// Add small proportionate perturbation to dimensions of ellipse\n\t\trx += getOffset(-rx*0.01f, rx*0.01f);\n\t\try += getOffset(-ry*0.01f, ry*0.01f);\n\n\t\t// Ensure start and stop angles are positive and sensible.\n\t\tfloat strt = start;\n\t\tfloat stp = stop;\n\n\t\twhile (strt < 0)\n\t\t{\n\t\t\tstrt += PConstants.TWO_PI;\n\t\t\tstp += PConstants.TWO_PI;\n\t\t}\n\n\t\tif (stp - strt > PConstants.TWO_PI) \n\t\t{\n\t\t\tstrt = 0;\n\t\t\tstp = PConstants.TWO_PI;\n\t\t}\n\n\t\tfloat arcInc = Math.min(ellipseInc/2,(stp-strt)/2);\n\n\t\t// Create a curved polygon to represent the sector.\n\t\tboolean oIsStroke = graphics.stroke;\n\t\tboolean oIsFill = graphics.fill;\n\t\tint oStroke = graphics.strokeColor;\n\t\tint oFill = graphics.fillColor;\n\n\t\tgraphics.noStroke();\n\n\t\tbeginShape();\n\t\tcurveVertex(cx+rx*(float)Math.cos(strt), cy+ry*(float)Math.sin(strt));\n\n\t\tfor (float theta=strt; theta<=stp; theta+=arcInc)\n\t\t{\n\t\t\tcurveVertex(cx+rx*(float)Math.cos(theta), cy+ry*(float)Math.sin(theta));\n\t\t}\n\n\t\t// Last control point should be duplicate the last point of the arc.\t\n\t\tcurveVertex(cx+rx*(float)Math.cos(stp), cy+ry*(float)Math.sin(stp));\n\t\tcurveVertex(cx+rx*(float)Math.cos(stp), cy+ry*(float)Math.sin(stp));\n\t\tvertex(cx+rx*(float)Math.cos(stp), cy+ry*(float)Math.sin(stp));\n\n\t\tvertex(cx,cy);\n\t\tendShape();\n\n\n\t\t// Draw outside edge of arc if we have a stroke.\n\t\tif (oIsStroke)\n\t\t{\n\t\t\tgraphics.stroke(oStroke);\n\t\t\tgraphics.noFill();\n\n\t\t\tbeginShape();\n\t\t\tcurveVertex(cx+rx*(float)Math.cos(strt), cy+ry*(float)Math.sin(strt));\n\n\t\t\tfor (float theta=strt; theta<=stp; theta+=arcInc)\n\t\t\t{\n\t\t\t\tcurveVertex(cx+rx*(float)Math.cos(theta), cy+ry*(float)Math.sin(theta));\n\t\t\t}\n\n\t\t\t// Last control point should be duplicate the last point of the arc.\t\n\t\t\tcurveVertex(cx+rx*(float)Math.cos(stp), cy+ry*(float)Math.sin(stp));\n\t\t\tcurveVertex(cx+rx*(float)Math.cos(stp), cy+ry*(float)Math.sin(stp));\n\n\t\t\tendShape();\n\t\t}\n\n\t\t// Restore original stroke and fill settings.\n\t\tgraphics.strokeColor = oStroke;\n\t\tgraphics.stroke = oIsStroke;\n\t\tgraphics.fillColor = oFill;\n\t\tgraphics.fill = oIsFill;\n\t}\n\n\t/** Starts a new shape of type POLYGON. This must be paired with a call to \n\t * endShape() or one of its variants.\n\t */\n\tpublic void beginShape()\n\t{\n\t\tbeginShape(PConstants.POLYGON);\n\t}\n\n\t/** Starts a new shape of the type specified in the mode parameter. This must be paired\n\t * with a call to endShape() or one of its variants.\n\t *\t@param mode either POINTS, LINES, TRIANGLES, TRIANGLE_FAN, TRIANGLE_STRIP, QUADS, QUAD_STRIP\t \n\t */\t\n\tpublic void beginShape(int mode)\n\t{\n\t\tif (isHandy == false)\n\t\t{\n\t\t\tgraphics.beginShape(mode);\n\t\t}\n\t\telse\n\t\t{\n\t\t\tthis.shapeMode=mode;\n\t\t\tvertices.clear();\n\t\t\tcurveIndices.clear();\n\t\t\tis3DShape = false;\n\t\t}\n\t}\n\n\t/** Adds a 2d vertex to a shape that was started with a call to beginShape() \n\t * or one of its variants.\n\t * @param x x coordinate of vertex to add.\n\t * @param y y coordinate of vertex to add.\n\t */\n\tpublic void vertex(float x, float y)\n\t{\n\t\tif (isHandy == false)\n\t\t{\n\t\t\tgraphics.vertex(x,y);\n\t\t}\n\t\telse\n\t\t{\n\t\t\tvertices.add(new float[] {x,y});\n\t\t}\n\t}\n\n\t/** Adds a 3d vertex to a shape that was started with a call to beginShape() \n\t * or one of its variants.\n\t * @param x x coordinate of vertex to add.\n\t * @param y y coordinate of vertex to add.\n\t * @param z z coordinate of vertex to add.\n\t */\n\tpublic void vertex(float x, float y, float z)\n\t{\n\t\tis3DShape = true;\n\t\tif (isHandy == false)\n\t\t{\n\t\t\tgraphics.vertex(x,y,z);\n\t\t}\n\t\telse\n\t\t{\n\t\t\tvertices.add(new float[] {x,y,z});\n\t\t}\n\t}\n\n\t/** Adds a 2d vertex to a shape or line that has curved edges. That shape should have been\n\t * started with a call to beginShape() without any parameter.\n\t * @param x x coordinate of vertex to add.\n\t * @param y y coordinate of vertex to add.\n\t */\n\tpublic void curveVertex(float x, float y)\n\t{\n\t\tif (isHandy == false)\n\t\t{\n\t\t\tgraphics.curveVertex(x,y);\n\t\t}\n\t\telse\n\t\t{\n\t\t\t// Log this position in the vertex list as being a curve\n\t\t\tcurveIndices.add(new Integer(vertices.size()));\n\n\t\t\t// Store the vertex geometry.\n\t\t\tvertices.add(new float[] {x,y});\t\t\t\n\t\t}\n\t}\n\n\t/** Adds a 3d vertex to a shape or line that has curved edges. That shape should have been\n\t * started with a call to beginShape() without any parameter.\n\t * @param x x coordinate of vertex to add.\n\t * @param y y coordinate of vertex to add.\n\t * @param z z coordinate of vertex to add.\n\t */\n\tpublic void curveVertex(float x, float y, float z)\n\t{\n\t\tis3DShape = true;\n\t\tif (isHandy == false)\n\t\t{\n\t\t\tgraphics.curveVertex(x,y,z);\n\t\t}\n\t\telse\n\t\t{\n\t\t\t// Log this position in the vertex list as being a curve\n\t\t\tcurveIndices.add(new Integer(vertices.size()));\n\n\t\t\t// Store the vertex geometry.\n\t\t\tvertices.add(new float[] {x,y,z});\t\t\t\n\t\t}\n\t}\n\n\t/** Ends a shape definition. This should have been paired with a call to beginShape()\n\t * or one of its variants. Note that this version will not close the shape if the last vertex does \n\t * not match the first one.\n\t */\n\tpublic void endShape()\n\t{\n\t\tif (isHandy == false)\n\t\t{\n\t\t\tgraphics.endShape();\n\t\t}\n\t\telse\n\t\t{\n\t\t\tif (is3DShape)\n\t\t\t{\n\t\t\t\tdrawShape3d(false);\n\t\t\t\tis3DShape = false;\n\t\t\t}\n\t\t\telse\n\t\t\t{\n\t\t\t\tdrawShape2d(false);\n\t\t\t}\n\n\t\t\tvertices.clear();\n\t\t\tcurveIndices.clear();\n\t\t}\n\t}\n\n\t/** Ends a shape definition. This should have been paired with a call to beginShape() \n\t * or one of its variants. If the mode parameter CLOSE the shape will be closed.\n\t * @param mode Type of shape closure.\n\t */\n\tpublic void endShape(int mode) \n\t{\n\t\tif (isHandy == false)\n\t\t{\n\t\t\tgraphics.endShape(mode);\n\t\t}\n\t\telse\n\t\t{\n\t\t\tif (is3DShape)\n\t\t\t{\n\t\t\t\tdrawShape3d(mode==PConstants.CLOSE);\n\t\t\t\tis3DShape = false;\n\t\t\t}\n\t\t\telse\n\t\t\t{\n\t\t\t\tdrawShape2d(mode==PConstants.CLOSE);\n\t\t\t}\n\t\t}\n\t\tvertices.clear();\n\t\tcurveIndices.clear();\n\t}\n\n\t/** Draws 3D cube with the given unit dimension.\n\t * @param bSize Size of each dimension of the cube.\n\t */\n\tpublic void box(float bSize)\n\t{\n\t\tbox(bSize, bSize, bSize);\n\t}\n\n\t/** Draws 3D box with the given dimensions.\n\t * @param bWidth Width of the box.\n\t * @param bHeight Height of the box.\n\t * @param bDepth Depth of the box.\n\t */\n\tpublic void box(float bWidth, float bHeight, float bDepth)\n\t{\n\t\tif (isHandy == false)\n\t\t{\n\t\t\tgraphics.box(bWidth,bHeight,bDepth);\n\t\t}\n\t\telse\n\t\t{\t\t\t\n\t\t\t// Create a box without any strokes first.\n\t\t\tfloat bW = bWidth/2f;\n\t\t\tfloat bH = bHeight/2f;\n\t\t\tfloat bD = bDepth/2f;\n\t\t\tgraphics.pushStyle();\n\t\t\tboolean isStrokeOverridden = overrideStrokeColour;\n\t\t\tsetOverrideStrokeColour(false);\n\t\t\tgraphics.noStroke();\n\n\t\t\tbeginShape(PConstants.QUADS);\n\t\t\t vertex(-bW, bH, bD);\n\t\t\t vertex( bW, bH, bD);\n\t\t\t vertex( bW, -bH, bD);\n\t\t\t vertex(-bW, -bH, bD);\n\n\t\t\t vertex( bW, bH, bD);\n\t\t\t vertex( bW, bH, -bD);\n\t\t\t vertex( bW, -bH, -bD);\n\t\t\t vertex( bW, -bH, bD);\n\t\t\t \n\t\t\t vertex( bW, bH, -bD);\n\t\t\t vertex(-bW, bH, -bD);\n\t\t\t vertex(-bW, -bH, -bD);\n\t\t\t vertex( bW, -bH, -bD);\n\t\t\t \n\t\t\t vertex(-bW, bH, -bD);\n\t\t\t vertex(-bW, bH, bD);\n\t\t\t vertex(-bW, -bH, bD);\n\t\t\t vertex(-bW, -bH, -bD);\n\n\t\t\t vertex(-bW, bH, -bD);\n\t\t\t vertex( bW, bH, -bD);\n\t\t\t vertex( bW, bH, bD);\n\t\t\t vertex(-bW, bH, bD);\n\t\t\t \n\t\t\t vertex(-bW, -bH, -bD);\n\t\t\t vertex( bW, -bH, -bD);\n\t\t\t vertex( bW, -bH, bD);\n\t\t\t vertex(-bW, -bH, bD);\n\t\t\t endShape();\n\t\t\t \n\t\t\t graphics.popStyle();\n\t\t\t setOverrideStrokeColour(isStrokeOverridden);\n\t\t\t \n\t\t\t // Finally draw lines along each of the box edges.\n\t\t\t line(-bW, bH, bD, bW, bH, bD);\n\t\t\t line( bW, bH, bD, bW, -bH, bD);\n\t\t\t line( bW, -bH, bD,-bW, -bH, bD);\n\t\t\t line(-bW, -bH, bD,-bW, bH, bD);\n\n\t\t\t line( bW, bH, bD, bW, bH, -bD);\n\t\t\t line( bW, bH, -bD, bW, -bH, -bD);\n\t\t\t line( bW, -bH, -bD, bW, -bH, bD);\n\n\t\t\t line( bW, bH, -bD,-bW, bH, -bD);\n\t\t\t line(-bW, bH, -bD,-bW, -bH, -bD);\n\t\t\t line(-bW, -bH, -bD, bW, -bH, -bD);\n\n\t\t\t line(-bW, bH, -bD,-bW, bH, bD);\n\t\t\t line(-bW, -bH, bD,-bW, -bH, -bD);\n\t\t}\n\t}\n\n\t/** Draws a closed 2d polygon based on the given arrays of vertices.\n\t * @param xCoords x coordinates of the shape.\n\t * @param yCoords y coordinates of the shape.\n\t */\n\tpublic void shape(float[] xCoords, float[] yCoords)\n\t{\n\t\tshape(xCoords,yCoords,true);\n\t}\n\n\t/** Draws a closed 3d polygon based on the given arrays of vertices.\n\t * @param xCoords x coordinates of the shape.\n\t * @param yCoords y coordinates of the shape.\n\t * @param zCoords z coordinates of the shape.\n\t */\n\tpublic void shape(float[] xCoords, float[] yCoords, float[] zCoords)\n\t{\n\t\tshape(xCoords,yCoords,zCoords,true);\n\t}\n\n\t/** Draws a 2d polygon based on the given arrays of vertices. This version can \n\t * draw either open or closed shapes.\n\t * @param xCoords x coordinates of the shape.\n\t * @param yCoords y coordinates of the shape.\n\t * @param closeShape Boundary of shape will be closed if true.\n\t */\n\tpublic void shape(float[] xCoords, float[] yCoords, boolean closeShape)\n\t{\n\t\tif ((xCoords == null) || (yCoords == null) || (xCoords.length ==0) || (yCoords.length == 0))\n\t\t{\n\t\t\tSystem.err.println(\"No coordinates provided to shape().\");\n\t\t\treturn;\n\t\t}\t\t\t\n\n\t\tif (isHandy == false)\n\t\t{\n\t\t\tgraphics.beginShape();\n\t\t\tfor (int i=0; i 0))\n\t\t\t{\n\t\t\t\tgraphics.fill(bgColour);\n\t\t\t\tgraphics.noStroke();\n\t\t\t\tgraphics.beginShape();\n\t\t\t\tfor (int i=0; i 0)\n\t\t\t\t\t{\n\t\t\t\t\t\tsetHachureAngle(originalAngle + (2*rand.nextFloat()-1)*anglePerturbation);\n\t\t\t\t\t}\n\n\t\t\t\t\tif (fillWeight <=0)\n\t\t\t\t\t{\n\t\t\t\t\t\tgraphics.strokeWeight(oWeight/2f);\n\t\t\t\t\t}\n\t\t\t\t\telse\n\t\t\t\t\t{\n\t\t\t\t\t\tgraphics.strokeWeight(fillWeight);\n\t\t\t\t\t}\n\n\t\t\t\t\tfloat gap = fillGap;\t// Gap between adjacent lines.\n\t\t\t\t\tif (gap < 0)\n\t\t\t\t\t{\n\t\t\t\t\t\tgap = oWeight*4;\t\t\t\t\t\n\t\t\t\t\t}\n\n\t\t\t\t\t// TODO: Implement alternating shading for arbitrary shapes.\n\t\t\t\t\t//\t\t\t\tif (isAlternating)\n\t\t\t\t\t//\t\t\t\t{\n\t\t\t\t\t//\t\t\t\t\t// If zig-zag filling, increase gap to give approximately similar density.\n\t\t\t\t\t//\t\t\t\t\tgap *= 1.41f;\n\t\t\t\t\t//\t\t\t\t}\n\n\t\t\t\t\t//\t\t\t\tArrayList prevCoords= new ArrayList();\n\n\t\t\t\t\t// Iterate through each line that could intersect with the shape.\n\t\t\t\t\tHachureIterator it = new HachureIterator(top-1, bottom+1, left-1, right+1, gap, sinAngle, cosAngle, tanAngle);\n\n\t\t\t\t\tfloat[] rectCoords = null;\n\n\t\t\t\t\twhile ((rectCoords=it.getNextLine()) != null)\n\t\t\t\t\t{\n\t\t\t\t\t\tArrayList lines = getIntersectingLines(rectCoords,xCoords,yCoords);\n\n\t\t\t\t\t\tfor (int i=0; i 0)\n\t\t\t\t\t{\n\t\t\t\t\t\tsetHachureAngle(originalAngle);\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t}\n\n\t\t\t// Restore original fill and stroke weight settings.\n\t\t\tgraphics.fill(oFill);\n\t\t\tgraphics.strokeWeight(oWeight);\n\t\t}\n\n\t\t// Draw boundary of the shape.\n\t\tif ((oIsStroke) || (overrideStrokeColour))\n\t\t{\n\t\t\tif (overrideStrokeColour)\n\t\t\t{\n\t\t\t\tgraphics.stroke(strokeColour);\n\t\t\t}\n\t\t\telse\n\t\t\t{\n\t\t\t\tgraphics.stroke(oStroke);\t\n\t\t\t}\n\n\t\t\tif (strokeWeight > 0)\n\t\t\t{\n\t\t\t\tgraphics.strokeWeight(strokeWeight);\n\t\t\t}\n\t\t\telse\n\t\t\t{\n\t\t\t\tgraphics.strokeWeight(oWeight);\n\t\t\t}\n\n\t\t\tfor (int i=0; i 0))\n\t\t\t{\n\t\t\t\tgraphics.fill(bgColour);\n\t\t\t\tgraphics.noStroke();\n\t\t\t\tgraphics.beginShape();\n\t\t\t\tfor (int i=0; i 0)\n\t\t\t\t\t{\n\t\t\t\t\t\tsetHachureAngle(originalAngle + (2*rand.nextFloat()-1)*anglePerturbation);\n\t\t\t\t\t}\n\n\t\t\t\t\tif (fillWeight <=0)\n\t\t\t\t\t{\n\t\t\t\t\t\tgraphics.strokeWeight(oWeight/2f);\n\t\t\t\t\t}\n\t\t\t\t\telse\n\t\t\t\t\t{\n\t\t\t\t\t\tgraphics.strokeWeight(fillWeight);\n\t\t\t\t\t}\n\n\t\t\t\t\tfloat gap = fillGap;\t// Gap between adjacent lines.\n\t\t\t\t\tif (gap < 0)\n\t\t\t\t\t{\n\t\t\t\t\t\tgap = oWeight*4;\t\t\t\t\t\n\t\t\t\t\t}\n\t\t\t\t\tif (isAlternating)\n\t\t\t\t\t{\n\t\t\t\t\t\t// If zig-zag filling, increase gap to give approximately similar density.\n\t\t\t\t\t\tgap *= 1.41f;\n\t\t\t\t\t}\n\n\t\t\t\t\t// Do the drawing.\n\t\t\t\t\tdrawHachuredFace(xCoords, yCoords, zCoords, gap);\n\n\t\t\t\t\t// Restore hachure angle if requested.\n\t\t\t\t\tif (anglePerturbation > 0)\n\t\t\t\t\t{\n\t\t\t\t\t\tsetHachureAngle(originalAngle);\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t}\n\n\t\t\t// Restore original fill and stroke weight settings.\n\t\t\tgraphics.fill(oFill);\n\t\t\tgraphics.strokeWeight(oWeight);\n\n\t\t}\n\n\t\t// Draw boundary of the shape.\n\t\tif ((oIsStroke) || (overrideStrokeColour))\n\t\t{\n\t\t\tif (overrideStrokeColour)\n\t\t\t{\n\t\t\t\tgraphics.stroke(strokeColour);\n\t\t\t}\n\t\t\telse\n\t\t\t{\n\t\t\t\tgraphics.stroke(oStroke);\t\n\t\t\t}\n\n\t\t\tif (strokeWeight > 0)\n\t\t\t{\n\t\t\t\tgraphics.strokeWeight(strokeWeight);\n\t\t\t}\n\t\t\telse\n\t\t\t{\n\t\t\t\tgraphics.strokeWeight(oWeight);\n\t\t\t}\n\n\t\t\tfor (int i=0; i 0)\n\t\t\t{\n\t\t\t\tgraphics.strokeWeight(strokeWeight);\n\t\t\t}\n\n\t\t\tfor (int i=0; i 0)\n\t\t\t{\n\t\t\t\tgraphics.strokeWeight(strokeWeight);\n\t\t\t}\n\n\t\t\tline(x1,y1,x2,y2,2);\n\n\t\t\t// Restore original stroke settings.\n\t\t\tgraphics.popStyle();\n\t\t}\n\t}\n\n\t/** Draws a 3D line between the given coordinate triplets. \n\t * @param x1 x coordinate of the start of the line.\n\t * @param y1 y coordinate of the start of the line.\n\t * @param z1 z coordinate of the start of the line.\n\t * @param x2 x coordinate of the end of the line.\n\t * @param y2 y coordinate of the end of the line.\n\t * @param z2 z coordinate of the end of the line.\n\t */\n\tpublic void line(float x1, float y1, float z1, float x2, float y2, float z2)\n\t{\t\n\t\tif ((graphics.stroke) || (overrideStrokeColour))\n\t\t{\n\t\t\tif (isHandy == false)\n\t\t\t{\n\t\t\t\tgraphics.line(x1,y1,z1,x2,y2,z2);\n\t\t\t\treturn;\n\t\t\t}\n\n\t\t\tgraphics.pushStyle();\n\t\t\tif (overrideStrokeColour)\n\t\t\t{\n\t\t\t\tgraphics.stroke(strokeColour);\n\t\t\t}\n\n\t\t\tif (strokeWeight > 0)\n\t\t\t{\n\t\t\t\tgraphics.strokeWeight(strokeWeight);\n\t\t\t}\n\n\t\t\tline(x1,y1,z1,x2,y2,z2,2);\n\n\t\t\t// Restore original stroke settings.\n\t\t\tgraphics.popStyle();\n\t\t}\n\t}\n\n\t/** Converts an array list of numeric values into a floating point array.\n\t * Useful for methods that require primitive arrays of floats based on a dynamic collection.\n\t * @param list List of numbers to convert.\n\t * @return Array of floats representing the list.\n\t */\n\tpublic static float[] toArray(List list)\n\t{\n\t\tfloat[] array = new float[list.size()];\n\t\tfor (int i=0; i< list.size(); i++)\n\t\t{\n\t\t\tarray[i] = list.get(i).floatValue();\n\t\t}\n\t\treturn array;\n\t}\n\n\t// --------------------------------- Private methods --------------------------------- \n\n\t/** Draws a 2D line between the given coordinate pairs. This version allows the random offset of the \n\t * two end points to be set explicitly.\n\t * @param x1 x coordinate of the start of the line.\n\t * @param y1 y coordinate of the start of the line.\n\t * @param x2 x coordinate of the end of the line.\n\t * @param y2 y coordinate of the end of the line.\n\t * @param maxOffset Maximum random offset in pixel coordinates.\n\t */\n\tprivate void line(float x1, float y1, float x2, float y2, float maxOffset)\n\t{\t\t\t\t\n\t\tif (graphics.stroke)\n\t\t{\n\t\t\tif (isHandy == false)\n\t\t\t{\n\t\t\t\tgraphics.line(x1,y1,x2,y2);\n\t\t\t\treturn;\n\t\t\t}\n\t\t\tgraphics.pushStyle();\n\n\t\t\t// Ensure random perturbation is no more than 10% of line length.\n\t\t\tfloat lenSq = (x1-x2)*(x1-x2) + (y1-y2)*(y1-y2);\n\t\t\tfloat offset = maxOffset;\n\n\t\t\tif (maxOffset*maxOffset*100 > lenSq)\n\t\t\t{\n\t\t\t\toffset = (float)Math.sqrt(lenSq)/10;\n\t\t\t}\n\n\t\t\tfloat halfOffset = offset/2;\n\t\t\tfloat divergePoint = 0.2f + rand.nextFloat()*0.2f;\n\n\n\t\t\tif (useSecondary)\n\t\t\t{\n\t\t\t\tgraphics.fill(secondaryColour);\n\t\t\t}\n\t\t\telse\n\t\t\t{\n\t\t\t\tgraphics.noFill();\n\t\t\t}\n\n\t\t\t// This is the midpoint displacement value to give slightly bowed lines.\n\t\t\tfloat midDispX = bowing*maxOffset*(y2-y1)/200;\n\t\t\tfloat midDispY = bowing*maxOffset*(x1-x2)/200;\n\n\t\t\tmidDispX = getOffset(-midDispX,midDispX);\n\t\t\tmidDispY = getOffset(-midDispY,midDispY);\n\n\t\t\tgraphics.beginShape();\n\t\t\tgraphics.vertex( x1 + getOffset(-offset,offset), y1 +getOffset(-offset,offset));\n\t\t\tgraphics.curveVertex(x1 + getOffset(-offset,offset), y1 +getOffset(-offset,offset));\n\t\t\tgraphics.curveVertex(midDispX+x1+(x2 -x1)*divergePoint + getOffset(-offset,offset), midDispY+y1 + (y2-y1)*divergePoint +getOffset(-offset,offset));\n\t\t\tgraphics.curveVertex(midDispX+x1+2*(x2-x1)*divergePoint + getOffset(-offset,offset), midDispY+y1+ 2*(y2-y1)*divergePoint +getOffset(-offset,offset)); \n\t\t\tgraphics.curveVertex(x2 + getOffset(-offset,offset), y2 +getOffset(-offset,offset));\n\t\t\tgraphics.vertex( x2 + getOffset(-offset,offset), y2 +getOffset(-offset,offset));\n\t\t\tgraphics.endShape(); \n\t\t\t\n\t\t\tgraphics.beginShape();\n\t\t\tgraphics.vertex( x1 + getOffset(-halfOffset,halfOffset), y1 +getOffset(-halfOffset,halfOffset));\n\t\t\tgraphics.curveVertex(x1 + getOffset(-halfOffset,halfOffset), y1 +getOffset(-halfOffset,halfOffset));\n\t\t\tgraphics.curveVertex(midDispX+x1+(x2 -x1)*divergePoint + getOffset(-halfOffset,halfOffset), midDispY+y1 + (y2-y1)*divergePoint +getOffset(-halfOffset,halfOffset));\n\t\t\tgraphics.curveVertex(midDispX+x1+2*(x2-x1)*divergePoint + getOffset(-halfOffset,halfOffset), midDispY+y1+ 2*(y2-y1)*divergePoint +getOffset(-halfOffset,halfOffset)); \n\t\t\tgraphics.curveVertex(x2 + getOffset(-halfOffset,halfOffset), y2 +getOffset(-halfOffset,halfOffset));\n\t\t\tgraphics.vertex( x2 + getOffset(-halfOffset,halfOffset), y2 +getOffset(-halfOffset,halfOffset));\n\t\t\tgraphics.endShape();\n\n\t\t\tgraphics.popStyle();\n\t\t}\n\t}\n\n\n\t/** Draws a 3D line between the given coordinate triplet. This version allows the random offset of the \n\t * two end points to be set explicitly.\n\t * @param x1 x coordinate of the start of the line.\n\t * @param y1 y coordinate of the start of the line.\n\t * @param z1 z coordinate of the start of the line.\n\t * @param x2 x coordinate of the end of the line.\n\t * @param y2 y coordinate of the end of the line.\n\t * @param z2 z coordinate of the end of the line.\n\t * @param maxOffset Maximum random offset in pixel coordinates.\n\t */\n\tprivate void line(float x1, float y1, float z1, float x2, float y2, float z2, float maxOffset)\n\t{\t\t\n\t\tif (graphics.stroke)\n\t\t{\n\t\t\tif (isHandy == false)\n\t\t\t{\n\t\t\t\tgraphics.line(x1,y1,z2,x2,y2,z2);\n\t\t\t\treturn;\n\t\t\t}\n\n\t\t\tPVector v1 = new PVector(x2-x1,y2-y1,z2-z1);\n\t\t\tPVector vn = new PVector(x2-x1,y2-y1,z2-z1);\n\t\t\tvn.normalize();\n\n\n\t\t\t// Ensure random perturbation is no more than 10% of line length.\n\t\t\tfloat lenSq = v1.x*v1.x + v1.y*v1.y + v1.z*v1.z;\n\t\t\tfloat offset = maxOffset;\n\n\t\t\tif (maxOffset*maxOffset*100 > lenSq)\n\t\t\t{\n\t\t\t\toffset = (float)Math.sqrt(lenSq)/10;\n\t\t\t}\n\n\t\t\tfloat halfOffset = offset/2;\n\t\t\tfloat divergePoint = 0.2f + rand.nextFloat()*0.2f;\n\n\t\t\tgraphics.pushStyle();\n\n\t\t\tif (useSecondary)\n\t\t\t{\n\t\t\t\tgraphics.fill(secondaryColour);\n\t\t\t}\n\t\t\telse\n\t\t\t{\n\t\t\t\tgraphics.noFill();\n\t\t\t}\n\n\t\t\t// This is the midpoint displacement value to give slightly bowed lines.\n\t\t\tPVector v2 = new PVector(1,1,1);\n\t\t\tPVector vCross = vn.cross(v2);\n\t\t\tfloat v1Len = v1.mag();\n\n\t\t\tfloat midDispX = v1Len*vCross.x/200;\n\t\t\tfloat midDispY = v1Len*vCross.y/200;\n\t\t\tfloat midDispZ = v1Len*vCross.z/200;\n\n\t\t\tmidDispX = getOffset(-midDispX,midDispX);\n\t\t\tmidDispY = getOffset(-midDispY,midDispY);\n\t\t\tmidDispZ = getOffset(-midDispZ,midDispZ);\n\n\t\t\tgraphics.beginShape();\n\t\t\tgraphics.vertex(x1 + getOffset(-offset,offset), y1 +getOffset(-offset,offset), z1+getOffset(-offset,offset));\n\t\t\tgraphics.curveVertex(x1 + getOffset(-offset,offset), y1 +getOffset(-offset,offset), z1+getOffset(-offset,offset));\n\t\t\tgraphics.curveVertex(midDispX+x1 + v1.x*divergePoint + getOffset(-offset,offset), midDispY+y1 + v1.y*divergePoint +getOffset(-offset,offset), midDispZ+z1 + v1.z*divergePoint +getOffset(-offset,offset));\n\t\t\tgraphics.curveVertex(midDispX+x1 +2*v1.x*divergePoint + getOffset(-offset,offset), midDispY+y1+ 2*v1.y*divergePoint +getOffset(-offset,offset), midDispZ+z1+ 2*v1.z*divergePoint +getOffset(-offset,offset)); \n\t\t\tgraphics.curveVertex(x2 + getOffset(-offset,offset), y2 +getOffset(-offset,offset), z2 +getOffset(-offset,offset));\n\t\t\tgraphics.vertex(x2 + getOffset(-offset,offset), y2 +getOffset(-offset,offset), z2 +getOffset(-offset,offset));\n\t\t\tgraphics.endShape(); \n\n\t\t\tgraphics.beginShape();\n\t\t\tgraphics.vertex(x1 + getOffset(-halfOffset,halfOffset), y1 +getOffset(-halfOffset,halfOffset), z1 +getOffset(-halfOffset,halfOffset));\n\t\t\tgraphics.curveVertex(x1 + getOffset(-halfOffset,halfOffset), y1 +getOffset(-halfOffset,halfOffset), z1 +getOffset(-halfOffset,halfOffset));\n\t\t\tgraphics.curveVertex(midDispX+x1+v1.x*divergePoint + getOffset(-halfOffset,halfOffset), midDispY+y1 + v1.y*divergePoint +getOffset(-halfOffset,halfOffset), midDispZ+z1 + v1.z*divergePoint +getOffset(-halfOffset,halfOffset));\n\t\t\tgraphics.curveVertex(midDispX+x1+2*v1.x*divergePoint + getOffset(-halfOffset,halfOffset), midDispY+y1+ 2*v1.y*divergePoint +getOffset(-halfOffset,halfOffset), midDispZ+z1+ 2*v1.z*divergePoint +getOffset(-halfOffset,halfOffset)); \n\t\t\tgraphics.curveVertex(x2 + getOffset(-halfOffset,halfOffset), y2 +getOffset(-halfOffset,halfOffset), z2 +getOffset(-halfOffset,halfOffset));\n\t\t\tgraphics.vertex(x2 + getOffset(-halfOffset,halfOffset), y2 +getOffset(-halfOffset,halfOffset), z2 +getOffset(-halfOffset,halfOffset));\n\t\t\tgraphics.endShape();\n\n\t\t\tgraphics.popStyle();\n\t\t}\n\t}\n\n\t/** Draws a 2D shape after it has been finished with endShape().\n\t * @param closeShape True if the shape is to be closed.\n\t */\n\tprivate void drawShape2d(boolean closeShape)\n\t{\n\t\t// Shapes with at least one curve vertex are a special case.\n\t\tif (curveIndices.size() > 0)\n\t\t{\n\t\t\tcurvedShape();\n\t\t\treturn;\n\t\t}\n\n\t\tfloat[] xs=new float[vertices.size()];\n\t\tfloat[] ys=new float[vertices.size()];\n\n\t\tint i=0;\n\t\tfor (float[] coords : vertices)\n\t\t{\n\t\t\txs[i]=coords[0];\n\t\t\tys[i]=coords[1];\n\t\t\ti++;\n\t\t}\n\n\t\tif (this.shapeMode==PConstants.POLYGON)\n\t\t{\n\t\t\tshape(xs,ys,closeShape);\n\t\t}\n\t\telse if (this.shapeMode==PConstants.LINES)\n\t\t{\n\t\t\tfor (i=0;iendShape().\n\t * @param closeShape True if the shape is to be closed.\n\t */\n\tprivate void drawShape3d(boolean closeShape)\n\t{\n\t\t// Shapes with at least one curve vertex are a special case.\n\t\tif (curveIndices.size() > 0)\n\t\t{\n\t\t\tcurvedShape();\n\t\t\treturn;\n\t\t}\n\n\t\tfloat[] xs=new float[vertices.size()];\n\t\tfloat[] ys=new float[vertices.size()];\n\t\tfloat[] zs=new float[vertices.size()];\n\n\t\tint i=0;\n\t\tfor (float[] coords : vertices)\n\t\t{\n\t\t\txs[i]=coords[0];\n\t\t\tys[i]=coords[1];\n\t\t\tzs[i]=coords[2];\n\t\t\ti++;\n\t\t}\n\n\t\tif (this.shapeMode==PConstants.POLYGON)\n\t\t{\n\t\t\tshape(xs,ys,zs,closeShape);\n\t\t}\n\t\telse if (this.shapeMode==PConstants.LINES)\n\t\t{\n\t\t\tfor (i=0;i coords = new ArrayList();\n\n\t\t\tv0 = vertices.get(0);\n\t\t\tv0[0] += getOffset(-2, 2);\n\t\t\tv0[1] += getOffset(-2, 2);\n\n\t\t\tv0Prime = vertices.get(0);\n\t\t\tv0Prime[0] += getOffset(-2, 2);\n\t\t\tv0Prime[1] += getOffset(-2, 2);\n\n\t\t\tfor (int i=0; i=3)\n\t\t\t\t\t{\n\t\t\t\t\t\t// Add enough vertices to approximate curve with a straight line.\n\t\t\t\t\t\tfloat dist = distSq(v2[0], v2[1], v1[0], v1[1]);\n\t\t\t\t\t\tfloat step = (25 + 300*roughness)/dist;\n\n\t\t\t\t\t\tfor (float t=0; t<1; t+= step)\n\t\t\t\t\t\t{\n\t\t\t\t\t\t\tfloat x = graphics.curvePoint(v3[0], v2[0], v1[0], v0[0], t); \n\t\t\t\t\t\t\tfloat y = graphics.curvePoint(v3[1], v2[1], v1[1], v0[1], t);\n\t\t\t\t\t\t\tcoords.add(new float[] {x,y});\n\t\t\t\t\t\t}\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t}\n\n\t\t\t// Convert coordinates into array and send to shape to fill.\n\t\t\tfloat[] xs=new float[coords.size()];\n\t\t\tfloat[] ys=new float[coords.size()];\n\t\t\tint i=0;\n\t\t\tfor (float[] vertex : coords)\n\t\t\t{\n\t\t\t\txs[i]=vertex[0];\n\t\t\t\tys[i]=vertex[1];\n\t\t\t\ti++;\n\t\t\t}\n\n\t\t\t// Temporarily disable stroke settings while we draw the interior.\n\t\t\tboolean isOStroke = graphics.stroke;\n\t\t\tboolean oOverrideStroke = overrideStrokeColour;\n\t\t\tint oStroke = graphics.strokeColor;\n\n\t\t\tgraphics.noStroke();\n\t\t\toverrideStrokeColour = false;\n\n\t\t\tshape(xs, ys);\n\n\t\t\tgraphics.stroke = isOStroke;\n\t\t\toverrideStrokeColour = oOverrideStroke;\n\t\t\tif (overrideStrokeColour)\n\t\t\t{\n\t\t\t\tgraphics.stroke(strokeColour);\n\t\t\t}\n\t\t\telse if (graphics.stroke)\n\t\t\t{\n\t\t\t\tgraphics.stroke(oStroke);\t\n\t\t\t}\n\t\t}\n\n\t\t// Draw the outlines as curved lines.\n\t\tif ((graphics.stroke) || (overrideStrokeColour))\n\t\t{\n\t\t\tboolean oOverrideFill = overrideFillColour;\n\n\t\t\tgraphics.noFill();\n\t\t\toverrideFillColour = false;\n\t\t\tif (strokeWeight > 0)\n\t\t\t{\n\t\t\t\tgraphics.strokeWeight(strokeWeight);\n\t\t\t}\n\n\t\t\tv0 = vertices.get(0);\n\t\t\tv0[0] += getOffset(-2, 2);\n\t\t\tv0[1] += getOffset(-2, 2);\n\n\t\t\tv0Prime = vertices.get(0);\n\t\t\tv0Prime[0] += getOffset(-2, 2);\n\t\t\tv0Prime[1] += getOffset(-2, 2);\n\n\t\t\tfor (int i=0; i 0)\n\t\t\t\t\t{\n\t\t\t\t\t\tline(v1[0],v1[1],v0[0],v0[1]);\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t\telse\n\t\t\t\t{\n\t\t\t\t\tif (i >=3)\n\t\t\t\t\t{\n\t\t\t\t\t\t// We have enough to generate a curve.\n\t\t\t\t\t\tgraphics.curve(v3[0], v3[1], v2[0], v2[1], v1[0], v1[1], v0[0], v0[1]);\n\t\t\t\t\t\tgraphics.curve(v3Prime[0], v3Prime[1], v2Prime[0], v2Prime[1], v1Prime[0], v1Prime[1], v0Prime[0], v0Prime[1]);\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t}\n\n\t\t\toverrideFillColour = oOverrideFill;\n\t\t}\n\n\t\t// Restore styles.\n\t\tgraphics.popStyle();\n\t}\n\n\n\t/** Generates a random offset scaled around the given range. Note that the offset can exceed\n\t * the given maximum or minimum depending on the sketchiness of the renderer settings.\n\t * @param minVal Approximate minimum value around which the offset is generated.\n\t * @param maxVal Approximate maximum value around which the offset is generated.\n\t */\n\tprivate float getOffset(float minVal, float maxVal)\n\t{\n\t\treturn roughness*(rand.nextFloat()*(maxVal-minVal)+minVal);\n\t}\n\n\t/** Adds the curved vertices to build an ellipse.\n\t * @param cx x coordinate of the centre of the ellipse.\n\t * @param cy y coordinate of the centre of the ellipse.\n\t * @param rx Radius in the x direction of the ellipse.\n\t * @param ry Radius in the y direction of the ellipse.\n\t */\n\tprivate void buildEllipse(float cx, float cy, float rx, float ry, float offset, float overlap)\n\t{\n\t\tfloat radialOffset = getOffset(-0.5f,0.5f)-PConstants.HALF_PI;\n\n\t\tgraphics.beginShape();\n\n\t\t// First control point should be penultimate point on ellipse.\t\n\t\tgraphics.curveVertex(getOffset(-offset,offset)+cx+0.9f*rx*(float)Math.cos(radialOffset-ellipseInc),\n\t\t\t\tgetOffset(-offset,offset)+cy+0.9f*ry*(float)Math.sin(radialOffset-ellipseInc));\n\n\t\tfor (float theta=radialOffset; theta getIntersectingLines(float[] lineCoords, float[]xCoords, float[]yCoords)\n\t{\n\t\tTreeMap intersections = new TreeMap();\n\t\tSegment s1 = new Segment(lineCoords[0],lineCoords[1],lineCoords[2],lineCoords[3]);\n\n\t\t// Final all points of intersection between line and shape boundary and ensure they are ordered from the start of the line.\n\t\tfor (int i=0; i(intersections.values());\n\t}\n\n\t/** Calculates the squared distance between a given pair of points.\n\t * @param x1 x coordinate of first point.\n\t * @param y1 y coordinate of first point.\n\t * @param x2 x coordinate of second point.\n\t * @param y2 y coordinate of second point.\n\t * @return Squared distance between points.\n\t */\n\tprivate static float distSq(float x1, float y1, float x2, float y2)\n\t{\n\t\treturn (x1-x2)*(x1-x2) + (y1-y2)*(y1-y2);\n\t}\n}\n" }, { "path": "Handy/src/org/gicentre/handy/Segment.java", "content": "package org.gicentre.handy;\n\nimport java.awt.geom.Point2D;\n\n// ******************************************************************************************\n/** Stores a directional 2d straight line segment. Can be used for geometric queries such as\n * line intersection.\n * @author Jo Wood\n * @version 2.4, 3rd January, 2012..\n */\n//*******************************************************************************************\n\n/* This file is part of Handy sketchy drawing library. Handy is free software: you can \n * redistribute it and/or modify it under the terms of the GNU Lesser General Public License\n * as published by the Free Software Foundation, either version 3 of the License, or (at your\n * option) any later version.\n * \n * Handy is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY;\n * without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. \n * See the GNU Lesser General Public License for more details.\n * \n * You should have received a copy of the GNU Lesser General Public License along with this\n * source code (see COPYING.LESSER included with this source code). If not, see \n * http://www.gnu.org/licenses/.\n */\n\nclass Segment\n{\n\t// -------------- Class and object variables ------------- \n\n\tenum Relation {LEFT, RIGHT, INTERSECTS, AHEAD, BEHIND, SEPARATE, UNDEFINED}\n\n\tprivate float px1,py1, // Start and end point of the segment.\n\t\t\t\t px2,py2; \n\n\tprivate double a,b,c; // Cartesian line equation parameters aX+bY+c=0\n\n\tprivate boolean undefined; // True if segment undefined.\n\tprivate float xi,yi; // Point of intersection.\n\n\n\t// ---------------------- Constructor ---------------------\n\n\t/** Creates a line segment from the two given end points.\n\t * @param px1 x-coordinate of first point on segment.\n\t * @param py1 y-coordinate of first point on segment.\n\t * @param px2 x-coordinate of second point on segment.\n\t * @param py2 y-coordinate of second point on segment.\n\t */\n\tSegment(float px1,float py1, float px2, float py2)\n\t{ \n\t\tthis.px1 = px1;\n\t\tthis.py1 = py1;\n\t\tthis.px2 = px2;\n\t\tthis.py2 = py2;\n\n\t\txi = Float.MAX_VALUE;\n\t\tyi = Float.MAX_VALUE;\n\n\t\t// Calculate Cartesian equation of the line.\n\t\ta=py2-py1;\n\t\tb=px1-px2;\n\t\tc=px2*py1-px1*py2;\n\n\t\t// Check p1 and p2 are two separate points.\n\t\tif ((a==0) && (b==0) && (c==0))\n\t\t{\n\t\t\tundefined = true;\n\t\t}\n\t\telse\n\t\t{\n\t\t\tundefined = false;\n\t\t}\n\t}\n\n\t// ------------------------ Methods -----------------------\n\n\t/** Determines if and where the given segment intersects with this one.\n\t * @param otherSegment Segment which which to compare.\n\t * @return Either INTERSECTS if the two segments cross, SEPARATE if \n\t * they do not or UNDEFINED if either segment is undefined.\n\t */\n\tRelation compare(Segment otherSegment)\n\t{ \n\t\tif ((isUndefined()) || (otherSegment.isUndefined())) \n\t\t{\n\t\t\treturn Relation.UNDEFINED; \n\t\t}\n\n\t\tdouble grad1 = Double.MAX_VALUE, // The two gradients.\n\t\tgrad2 = Double.MAX_VALUE; \n\t\tdouble int1 = 0, // The two intercepts.\n\t\tint2 = 0; \n\n\t\t// Find gradient and intercept of first line.\n\t\tif (Math.abs(b) > 0.00001)\n\t\t{\n\t\t\tgrad1 = -a/b;\n\t\t\tint1 = -c/b;\n\t\t}\n\n\t\t// Find gradient and intercept of second line.\n\n\t\tif (Math.abs(otherSegment.getB()) > 0.00001)\n\t\t{\n\t\t\tgrad2 = -otherSegment.getA()/otherSegment.getB();\n\t\t\tint2 = -otherSegment.getC()/otherSegment.getB();\n\t\t}\n\n\t\t// Solve simultaneous equations.\n\n\t\tif (grad1 == Double.MAX_VALUE) // Line 1 vertical.\n\t\t{\n\t\t\tif (grad2 == Double.MAX_VALUE) // 2 parallel vertical lines.\n\t\t\t{\n\t\t\t\t// Segments two distinct parallel lines.\n\t\t\t\tif (-c/a != -otherSegment.getC()/otherSegment.getA())\n\t\t\t\t{\n\t\t\t\t\treturn Relation.SEPARATE;\n\t\t\t\t}\n\n\t\t\t\t// Segments overlap along same vertical line. \n\t\t\t\tif ((py1 >= Math.min(otherSegment.getPy1(),otherSegment.getPy2())) &&\n\t\t\t\t\t\t(py1 <= Math.max(otherSegment.getPy1(),otherSegment.getPy2())))\n\t\t\t\t{\n\t\t\t\t\txi = px1;\n\t\t\t\t\tyi = py1;\n\t\t\t\t\treturn Relation.INTERSECTS;\n\t\t\t\t}\n\n\t\t\t\tif ((py2 >= Math.min(otherSegment.getPy1(),otherSegment.getPy2())) &&\n\t\t\t\t\t\t(py2 <= Math.max(otherSegment.getPy1(),otherSegment.getPy2())))\n\t\t\t\t{\n\t\t\t\t\txi = px2;\n\t\t\t\t\tyi = py2;\n\t\t\t\t\treturn Relation.INTERSECTS;\n\t\t\t\t}\n\n\t\t\t\t// Separate segments on same vertical parallel line.\n\t\t\t\treturn Relation.SEPARATE;\n\t\t\t}\n\n\t\t\t// Line 1 vertical, line 2 not parallel to it.\n\t\t\txi = px1; // was -c/a;\n\t\t\tyi = (float)(grad2*xi+int2);\n\t\t\t\n\t\t\tif (((py1-yi)*(yi-py2) < -0.00001) || ((otherSegment.getPy1()-yi)*(yi-otherSegment.getPy2()) < -0.00001))\n\t\t\t{\n\t\t\t\treturn Relation.SEPARATE;\n\t\t\t}\n\t\t\t// Line 2 is horizontal, line 1 is vertical.\n\t\t\tif (Math.abs(otherSegment.getA()) < 0.00001)\n\t\t\t{\n\t\t\t\tif ((otherSegment.getPx1()-xi)*(xi-otherSegment.getPx2()) < -0.00001)\n\t\t\t\t{\n\t\t\t\t\treturn Relation.SEPARATE;\n\t\t\t\t}\n\t\t\t\treturn Relation.INTERSECTS;\n\t\t\t}\n\t\t\treturn Relation.INTERSECTS;\n\t\t}\n\n\t\t// Line 2 vertical, line 1 not-parallel to it.\n\t\tif (grad2 == Double.MAX_VALUE) \n\t\t{\n\t\t\txi = otherSegment.getPx1(); //(float)(-otherSegment.getC()/otherSegment.getA());\n\t\t\tyi = (float)(grad1*xi+int1);\n\n\t\t\tif (((otherSegment.getPy1()-yi)*(yi-otherSegment.getPy2()) < -0.00001) || ((py1-yi)*(yi-py2) < -0.00001))\n\t\t\t{\n\t\t\t\treturn Relation.SEPARATE;\n\t\t\t}\n\t\t\t// Line 1 is horizontal, line 2 is vertical.\n\t\t\tif (Math.abs(a) < 0.00001)\n\t\t\t{\n\t\t\t\tif ((px1-xi)*(xi-px2) < -0.00001)\n\t\t\t\t{\n\t\t\t\t\treturn Relation.SEPARATE;\n\t\t\t\t}\n\t\t\t\treturn Relation.INTERSECTS;\n\t\t\t}\n\t\t\treturn Relation.INTERSECTS;\n\t\t}\n\n\t\t// Two lines are parallel but not vertical.\n\t\tif (grad1 == grad2)\n\t\t{\n\t\t\t// Two lines are parallel and separate.\n\t\t\tif (int1 != int2)\n\t\t\t{\n\t\t\t\treturn Relation.SEPARATE;\n\t\t\t}\n\n\t\t\t// Segments overlap along same non-vertical line. \n\t\t\tif ((px1 >= Math.min(otherSegment.getPx1(),otherSegment.getPx2())) &&\n\t\t\t\t(px1 <= Math.max(otherSegment.getPy1(),otherSegment.getPy2())))\n\t\t\t{\n\t\t\t\txi = px1;\n\t\t\t\tyi = py1;\n\t\t\t\treturn Relation.INTERSECTS;\n\t\t\t}\n\n\t\t\tif ((px2 >= Math.min(otherSegment.getPx1(),otherSegment.getPx2())) &&\n\t\t\t\t(px2 <= Math.max(otherSegment.getPx1(),otherSegment.getPx2())))\n\t\t\t{\n\t\t\t\txi = px2;\n\t\t\t\tyi = py2;\n\t\t\t\treturn Relation.INTERSECTS;\n\t\t\t}\n\n\t\t\t// Separate segments on same non-vertical parallel line.\n\t\t\treturn Relation.SEPARATE; \n\t\t}\n\n\t\t// If we get this far, all special cases have been dealt with.\n\t\txi = (float)((int2-int1)/(grad1-grad2));\n\t\tyi = (float)(grad1*xi + int1);\n\n\t\tif (((px1-xi)*(xi-px2) < -0.00001) || ((otherSegment.getPx1()-xi)*(xi-otherSegment.getPx2()) < -0.00001))\n\t\t{\n\t\t\treturn Relation.SEPARATE;\n\t\t}\n\t\treturn Relation.INTERSECTS; \n\t}\n\n\t/** Determines where the given point is in relation to the segment.\n\t * @param px x-coordinate of point to compare.\n\t * @param py y-coordinate of point to compare.\n\t * @return Relative position of point (LEFT, RIGHT, AHEAD, BEHIND, INTERSECTS or UNDEFINED).\n\t */\n\tRelation compare(float px, float py)\n\t{\n\t\tif (undefined)\n\t\t{\n\t\t\treturn Relation.UNDEFINED;\n\t\t}\n\n\t\t// Test whether point falls on extended line.\n\t\tdouble s = a*px + b*py + c;\n\n\t\tif (s > 0.01)\n\t\t{\n\t\t\treturn Relation.RIGHT;\n\t\t}\n\n\t\tif (s < -0.01)\n\t\t{\n\t\t\treturn Relation.LEFT;\n\t\t}\n\n\t\t// Find out where on line point falls.\n\t\tdouble d;\n\n\t\tif (px2 == px1)\n\t\t{\n\t\t\td = (py-py1)/(py2-py1);\n\t\t}\n\t\telse \n\t\t{\n\t\t\td = (px-px1)/(px2-px1);\n\t\t}\n\n\t\tif (d < -0.001)\n\t\t{\n\t\t\treturn Relation.BEHIND;\n\t\t}\n\n\t\tif (d > 1.001)\n\t\t{\n\t\t\treturn Relation.AHEAD;\n\t\t}\n\n\t\treturn Relation.INTERSECTS;\n\t} \n\n\t/** Reports the distance between the given point and this segment.\n\t * @param px x coordinate of point to consider.\n\t * @param py y coordinate of point to consider.\n\t * @return distance between point and segment.\n\t */\n\tfloat calcDistance(float px, float py)\n\t{\n\t\t// Check for segment of zero length.\n\t\tif ((px1==px2) && (py1==py2))\n\t\t{\n\t\t\treturn (float)Math.sqrt((px-px1)*(px-px1) + (py-py1)*(py-py1));\n\t\t}\n\n\n\t\tdouble dx = px1-px2;\n\t\tdouble dy = py1-py2;\n\t\tdouble dist2 = dx*dx + dy*dy;\n\n\t\tdouble u = ((px-px1)*(px2-px1) + (py-py1)*(py2-py1)) / dist2;\n\n\n\t\tif (u < 0) // Nearest point is 'behind' line segment.\n\t\t{\n\t\t\treturn (float)getLength(px,py,px1,py1);\n\t\t}\n\n\t\tif (u > 1) // Nearest point is 'in front' of line segment.\n\t\t{\n\t\t\treturn (float)getLength(px,py,px2,py2);\n\t\t}\n\n\t\t// Nearest point lies in line segment.\n\t\treturn (float)Math.abs((((py2-py1)*(px-px1) - (px2-px1)*(py-py1)) /\n\t\t\t\tMath.sqrt(dist2)));\n\t}\n\n\t/** Reports the nearest point on the segment to the given point. If shortest distance\n\t * between point and line of infinite length through the segment is outside the segment's\n\t * bounds, the nearest segment endpoint is returned.\n\t * @param px x coordinate of point to consider.\n\t * @param py y coordinate of point to consider.\n\t * @return Location of nearest point on segment.\n\t */\n\tPoint2D nearestPoint(float px, float py)\n\t{\n\t\t// Check for segment of zero length.\n\t\tif ((px1==px2) && (py1==py2))\n\t\t{\n\t\t\treturn new Point2D.Float(px1,py1);\n\t\t}\n\n\t\tdouble dx = px1-px2;\n\t\tdouble dy = py1-py2;\n\t\tdouble dist2 = dx*dx + dy*dy;\n\n\t\tdouble u = ((px-px1)*(px2-px1) + (py-py1)*(py2-py1)) / dist2;\n\n\n\t\tif (u < 0) // Nearest point is 'behind' line segment.\n\t\t{\n\t\t\treturn new Point2D.Float(px1,py1);\n\t\t}\n\n\t\tif (u > 1) // Nearest point is 'in front' of line segment.\n\t\t{\n\t\t\treturn new Point2D.Float(px2,py2);\n\t\t}\n\n\t\t// Nearest point lies in line segment.\n\t\treturn new Point2D.Float((float)(px1 +u*(px2-px1)),(float)(py1 + u*(py2-py1)));\n\t}\n\n\t/** Reports whether intersection is with one of the segment's endpoints.\n\t * @return true if intersection is with one of the endpoints.\n\t */\n\tboolean intersectsEndpoint()\n\t{\n\t\tif ((xi == Float.MAX_VALUE) || (yi == Float.MAX_VALUE))\n\t\t\treturn false;\n\n\t\tfloat diff1 = Math.abs(px1-xi)+ Math.abs(py1-yi);\n\t\tfloat diff2 = Math.abs(px2-xi)+ Math.abs(py2-yi);\n\n\t\tif ((diff1 <0.1) || (diff2 <0.1))\n\t\t{\n\t\t\treturn true;\n\t\t}\n\t\treturn false;\n\t}\n\n\t// ----------------------- Accessor Methods ------------------------\n\n\t/** Reports the x coordinate of the start point of the segment.\n\t * @return x coordinate of the start point.\n\t */\n\tfloat getPx1()\n\t{\n\t\treturn px1;\n\t}\n\n\t/** Reports the y coordinate of the start point of the segment.\n\t * @return y coordinate of the start point.\n\t */\n\tfloat getPy1()\n\t{\n\t\treturn py1;\n\t} \n\n\t/** Reports the x coordinate of the end point of the segment.\n\t * @return x coordinate of the end point.\n\t */\n\tfloat getPx2()\n\t{\n\t\treturn px2;\n\t}\n\n\t/** Reports the y coordinate of the end point of the segment.\n\t * @return y coordinate of the end point.\n\t */\n\tfloat getPy2()\n\t{\n\t\treturn py2;\n\t} \n\n\t/** Reports whether segment is undefined (endpoints identical).\n\t * @return True if undefined line.\n\t */\n\tboolean isUndefined()\n\t{\n\t\treturn undefined;\n\t}\n\n\t/** Reports the 'a' coefficient of the Cartesian equation of the segment.\n\t * Cartesian equation is in the form aX + bY + c = 0.\n\t * @return a coefficient.\n\t */\n\tdouble getA()\n\t{\n\t\treturn a;\n\t}\n\n\t/** Reports the 'b' coefficient of the Cartesian equation of the segment.\n\t * Cartesian equation is in the form aX + bY + c = 0.\n\t * @return b coefficient.\n\t */\n\tdouble getB()\n\t{\n\t\treturn b;\n\t}\n\n\t/** Reports the 'c' coefficient of the Cartesian equation of the segment.\n\t * Cartesian equation is in the form aX + bY + c = 0.\n\t * @return c coefficient.\n\t */\n\tdouble getC()\n\t{\n\t\treturn c;\n\t}\n\n\t/** Reports the x coordinate of the intersection with last segment to be compared.\n\t * @return x coordinate of the intersection.\n\t */\n\tfloat getIntersectionX()\n\t{\n\t\treturn xi;\n\t}\n\n\t/** Reports the y coordinate of the intersection with last segment to be compared.\n\t * @return y coordinate of the intersection.\n\t */\n\tfloat getIntersectionY()\n\t{\n\t\treturn yi;\n\t}\n\n\t/** Reports the length of the segment.\n\t * @return Length of the segment.\n\t */\n\tfloat getLength()\n\t{ \n\t\treturn (float)getLength(px1,py1,px2,py2);\n\t}\n\n\t/** Reports the coordinates of this segment.\n\t * @return Textual representation of this segment.\n\t */\n\tpublic String toString()\n\t{ \n\t\treturn new String(\"Segment with vertices (\"+px1+\",\"+py1+\") (\"+px2+\",\"+py2+\")\");\n\t}\n\n\t// ---------------------- Private methods ---------------------\n\n\t/** Calculates the length of the line given by the two end point coordinates.\n\t */\n\tprivate static double getLength(double x1, double y1, double x2, double y2)\n\t{\n\t\tdouble dx = x2-x1;\n\t\tdouble dy = y2-y1;\n\n\t\treturn Math.sqrt(dx*dx + dy*dy);\n\t}\n}\n" }, { "path": "Handy/src/org/gicentre/handy/Simplifier.java", "content": "package org.gicentre.handy;\n\nimport java.util.ArrayList;\nimport processing.core.PVector;\n\n//*****************************************************************************************\n/** Performs Douglas-Peucker simplification on linear coordinate collections.\n * @author Jo Wood, giCentre, City University London.\n * @version 1.0, 3rd January, 2012.\n */ \n// *****************************************************************************************\n\n/* This file is part of Handy sketchy drawing library. Handy is free software: you can \n * redistribute it and/or modify it under the terms of the GNU Lesser General Public License\n * as published by the Free Software Foundation, either version 3 of the License, or (at your\n * option) any later version.\n * \n * Handy is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY;\n * without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. \n * See the GNU Lesser General Public License for more details.\n * \n * You should have received a copy of the GNU Lesser General Public License along with this\n * source code (see COPYING.LESSER included with this source code). If not, see \n * http://www.gnu.org/licenses/.\n */\n\npublic class Simplifier \n{\n\tprivate static ArrayList xCoords,yCoords; \t// Used for storing simplified coordinates.\n\tprivate static float[] xOriginal,yOriginal;\t\t\t// Original coordinates.\n\tprivate static float[] xSimp,ySimp;\t\t\t\t\t// Simplified coordinates.\n\tprivate static float tolerance;\n\t\n\n\t/** Creates a simplified version of the given collection of coordinates. Uses Douglas-Peucker simplification\n\t * using the given tolerance value. The greater the tolerance, the greater the simplification. \n\t * @param origCoords Coordinates to be simplified.\n\t * @param tol Douglas-Peucker tolerance (in spatial units).\n\t */\n\tpublic static void simplify(ArrayListorigCoords, float tol)\n\t{ \n\t\tSimplifier.tolerance = tol;\n\t\tint numCoords = origCoords.size();\n\t\txOriginal = new float[numCoords];\n\t\tyOriginal = new float[numCoords];\n\t\tfor (int i=0; i();\n\t\tyCoords = new ArrayList();\n\n\t\tdouglasPeucker(0,numCoords-1);\n\t\t\n\t\txSimp = new float[xCoords.size()];\n\t\tySimp = new float[yCoords.size()];\n\t\t\n\t\tfor (int i=0; i maxDist)\n\t\t\t{\n\t\t\t\tmaxDist = dist;\n\t\t\t\tfurthestNode = i;\n\t\t\t}\n\t\t}\n\n\t\tif (maxDist > tolerance)\n\t\t{\n\t\t\tdouglasPeucker(start,furthestNode);\n\t\t\tdouglasPeucker(furthestNode,end);\n\t\t}\n\t\telse\n\t\t{ \n\t\t\tFloat lastXCoord = null;\n\t\t\tFloat lastYCoord = null;\n\t\t\t\n\t\t\tif (xCoords.size() > 0)\n\t\t\t{\n\t\t\t\tlastXCoord = xCoords.get(xCoords.size()-1);\n\t\t\t\tlastYCoord = yCoords.get(xCoords.size()-1);\n\t\t\t}\n\t\t\t\n\t\t\tif ((xCoords.size() == 0) ||\n\t\t\t\t(((lastXCoord != null) && (lastYCoord != null)) &&\n\t\t\t\t ((lastXCoord.floatValue() != xOriginal[start]) ||\n\t\t\t\t (lastYCoord.floatValue() != yOriginal[start]))))\n\t\t\t{\n\t\t\t\txCoords.add(new Float(xOriginal[start]));\n\t\t\t\tyCoords.add(new Float(yOriginal[start]));\n\t\t\t}\n\n\t\t\tlastXCoord = xCoords.get(xCoords.size()-1);\n\t\t\tlastYCoord = yCoords.get(xCoords.size()-1);\n\t\t\t\n\t\t\tif (((lastXCoord != null) && (lastYCoord != null)) &&\n\t\t\t\t((lastXCoord.floatValue() != xOriginal[end]) ||\n\t\t\t\t(lastYCoord.floatValue() != yOriginal[end])))\n\t\t\t{\n\t\t\t\txCoords.add(new Float(xOriginal[end]));\n\t\t\t\tyCoords.add(new Float(yOriginal[end]));\n\t\t\t}\n\t\t}\n\t}\n}\n" }, { "path": "Handy/src/org/gicentre/handy/Version.java", "content": "package org.gicentre.handy;\n\n// *****************************************************************************************\n/** Stores version information about the Handy sketchy drawing package.\n * @author Jo Wood, giCentre, City University London.\n * @version 2.0, 4th April, 2016.\n */ \n// *****************************************************************************************\n\n/* This file is part of Handy sketchy drawing library. Handy is free software: you can \n * redistribute it and/or modify it under the terms of the GNU Lesser General Public License\n * as published by the Free Software Foundation, either version 3 of the License, or (at your\n * option) any later version.\n * \n * Handy is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY;\n * without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. \n * See the GNU Lesser General Public License for more details.\n * \n * You should have received a copy of the GNU Lesser General Public License along with this\n * source code (see COPYING.LESSER included with this source code). If not, see \n * http://www.gnu.org/licenses/.\n */\n\npublic class Version \n{\n\tprivate static final float VERSION = 2.0f;\n\tprivate static final String VERSION_TEXT = \"Handy sketchy drawing package V2.0, 4th April, 2016\";\n\n\t/** Reports the current version of the handy package.\n\t * @return Text describing the current version of this package.\n\t */\n\tpublic static String getText()\n\t{\n\t\treturn VERSION_TEXT;\n\t}\n\n\t/** Reports the numeric version of the handy package.\n\t * @return Number representing the current version of this package.\n\t */\n\tpublic static float getVersion()\n\t{\n\t\treturn VERSION;\n\t}\n}" }, { "path": "Handy/src/org/gicentre/handy/package.html", "content": "\n\n\n\n\n\nMain package for creating a handy renderer\n\n\n

\n This package includes the main classes for creating a handy renderer. Includes classes for producing\n rectangular hachures and for simplifying polylines.\n

\n\n\n

Related Documentation

\n\n\n\n\n\n
\n
Version 2.0, 4th April, 2016
\n
\n \n\n\n" }, { "path": "Handy/src/org/gicentre/tests/ArcTest.java", "content": "package org.gicentre.tests;\n\nimport org.gicentre.handy.HandyRenderer;\nimport org.gicentre.utils.move.ZoomPan;\n\nimport processing.core.PApplet;\nimport processing.core.PConstants;\n\n// *****************************************************************************************\n/** Simple sketch to test handy arc drawing.\n * Draws a set of randomly positioned arcs with sketchy shaded interiors. Can zoom and pan\n * by dragging mouse; 'R' to reset zoom/pan. 'H' to toggle sketchy rendering. Left and right\n * arrows to change angle of hachures. Up and down arrows to change degree of sketchiness.\n * A set of very small arcs are drawn which should not be visible in the sketchy view\n * but present as points in the non-sketchy view. \n * @author Jo Wood, giCentre, City University London.\n * @version 2.0, 2nd April, 2016\n */ \n// *****************************************************************************************\n\n/* This file is part of Handy sketchy drawing library. Handy is free software: you can \n * redistribute it and/or modify it under the terms of the GNU Lesser General Public License\n * as published by the Free Software Foundation, either version 3 of the License, or (at your\n * option) any later version.\n * \n * Handy is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY;\n * without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. \n * See the GNU Lesser General Public License for more details.\n * \n * You should have received a copy of the GNU Lesser General Public License along with this\n * source code (see COPYING.LESSER included with this source code). If not, see \n * http://www.gnu.org/licenses/.\n */\n\npublic class ArcTest extends PApplet \n{\n\t// ------------------------------ Starter method ------------------------------- \n\n\t/** Creates a simple application to test handy line drawing.\n\t * @param args Command line arguments (ignored). \n\t */\n\tpublic static void main(String[] args)\n\t{ \n\t\tPApplet.main(new String[] {\"org.gicentre.tests.ArcTest\"});\n\t}\n\n\t// ----------------------------- Object variables ------------------------------\n\n\tprivate HandyRenderer h;\t\t\t// Does the sketchy rendering.\n\tprivate ZoomPan zoomer;\t\t\t\t// For zooming and panning.\n\tprivate float angle;\t\t\t\t// Hachure angle.\n\tprivate boolean isHandy;\t\t\t// Toggles handy rendering on and off.\n\tprivate float roughness;\t\t\t// Degree of sketchiness.\n\t\n\t// ---------------------------- Processing methods -----------------------------\n\n\t/** Initial window settings prior to setup().\n\t */\n\tpublic void settings()\n\t{ \n\t\t\n\t\tsize(800,800);\n\t\t\n\t\t// Should work with all Processing 3 renderers.\n\t\t// size(800,800, P2D);\n\t\t// size(800,800, P3D);\n\t\t// size(800,800, FX2D);\n\t\t\n\t\tpixelDensity(displayDensity());\t\t// Use platform's maximum display density.\n\t}\n\t\n\t/** Sets up the sketch.\n\t */\n\tpublic void setup()\n\t{ \n\t\tzoomer = new ZoomPan(this);\n\t\tangle = -45;\n\t\troughness = 1;\n\t\tisHandy = true;\n\t\th = new HandyRenderer(this);\n\t\th.setHachureAngle(angle);\n\t\th.setHachurePerturbationAngle(5);\n\t\th.setIsHandy(isHandy);\n\t\th.setRoughness(roughness);\n\t}\n\t\t\n\t/** Draws some sketchy arcs.\n\t */\n\t@Override\n\tpublic void draw()\n\t{\n\t\tbackground(255);\n\t\tzoomer.transform();\n\t\tstroke(80);\n\t\tstrokeWeight(1f);\n\t\t\n\t\tint numArcs = 40;\n\t\th.setSeed(9876);\t\t// Ensures sketchy perturbations do not change on redraw.\n\t\trandomSeed(1245);\t\t// Ensures arcs remain in same location on redraw.\n\n\t\tfor (int i=0; i 0.01) \n\t\t{ \n\t\t\txmag -= diff/4.0; \n\t\t}\n\n\t\tdiff = ymag-newYmag;\n\t\tif (abs(diff) > 0.01) \n\t\t{ \n\t\t\tymag -= diff/4.0; \n\t\t}\n\n\t\trotateX(-ymag); \n\t\trotateY(-xmag); \n\t\t\n\t\ttranslate(0,-150,0);\n\t\th.box(lengthA,lengthB,lengthC);\n\t\t\n\t\t// This version uses the handy recorder but should appear identical to the other box.\n\t\tbeginRecord(handyRec);\n\t\ttranslate(0,300,0);\n\t\tbox(lengthA,lengthB,lengthC);\n\t\tendRecord();\n\t\t\n\t\tpopMatrix(); \n\t}\n\n\t/** Responds to key presses to control appearance of shapes.\n\t */\n\t@Override\n\tpublic void keyPressed()\n\t{\n\t\tif ((key =='h') || (key == 'H'))\n\t\t{\n\t\t\tisHandy = !isHandy;\n\t\t\th.setIsHandy(isHandy);\n\t\t}\n\n\t\tif (key == PConstants.CODED)\n\t\t{\n\t\t\tif (keyCode == PConstants.LEFT)\n\t\t\t{\n\t\t\t\tangle--;\n\t\t\t\th.setHachureAngle(angle);\n\t\t\t}\n\t\t\telse if (keyCode == PConstants.RIGHT)\n\t\t\t{\n\t\t\t\tangle++;\n\t\t\t\th.setHachureAngle(angle);\n\t\t\t}\n\t\t\telse if (keyCode == PConstants.UP)\n\t\t\t{\n\t\t\t\troughness *= 1.1;\n\t\t\t\th.setRoughness(roughness);\n\t\t\t}\n\t\t\telse if (keyCode == PConstants.DOWN)\n\t\t\t{\n\t\t\t\troughness *= 0.9;\n\t\t\t\th.setRoughness(roughness);\n\t\t\t}\n\t\t}\n\t}\n}" }, { "path": "Handy/src/org/gicentre/tests/ChartTest.java", "content": "package org.gicentre.tests;\n\nimport org.gicentre.handy.HandyRenderer;\nimport org.gicentre.utils.colour.ColourTable;\nimport org.gicentre.utils.gui.DrawableFactory;\nimport org.gicentre.utils.stat.BarChart;\nimport org.gicentre.utils.stat.XYChart;\n\nimport processing.core.PApplet;\nimport processing.core.PConstants;\nimport processing.core.PFont;\n\n// ****************************************************************************************\n/** Tests chart drawing in a simple Processing sketch. 'H' to toggle sketchy rendering. \n * Arrows to change bar gap. 'X' and 'Y' for toggling axes; 'T' for transposing axes.\n * 'L' for toggling log scaling.\n * @author Jo Wood, giCentre, City University London.\n * @version 2.0, 2nd April, 2016. \n */ \n// *****************************************************************************************\n\n/* This file is part of giCentre utilities library. gicentre.utils is free software: you can \n * redistribute it and/or modify it under the terms of the GNU Lesser General Public License\n * as published by the Free Software Foundation, either version 3 of the License, or (at your\n * option) any later version.\n * \n * gicentre.utils is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY;\n * without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. \n * See the GNU Lesser General Public License for more details.\n * \n * You should have received a copy of the GNU Lesser General Public License along with this\n * source code (see COPYING.LESSER included with this source code). If not, see \n * http://www.gnu.org/licenses/.\n */\n\npublic class ChartTest extends PApplet\n{\n\t// ------------------------------ Starter method ------------------------------- \n\n\t/** Creates a simple application to test the chart drawing utilities.\n\t * @param args Command line arguments (ignored). \n\t */\n\tpublic static void main(String[] args)\n\t{ \n\t\tPApplet.main(new String[] {\"org.gicentre.tests.ChartTest\"});\n\t}\n\n\t// ----------------------------- Object variables ------------------------------\n\n\tprivate HandyRenderer h;\t\t// Does the sketchy rendering.\n\tprivate boolean isHandy;\t\t// Toggles handy rendering on and off.\n\t\n\tprivate PFont sketchyFont,normalFont;\n\t\n\tprivate BarChart chart1;\n\tprivate XYChart chart2;\n\n\tprivate boolean showXAxis, showYAxis;\n\tprivate boolean transpose;\n\tprivate boolean useLog;\n\n\tprivate int barGap = 2;\n\tprivate int barPad = 0;\n\n\t// ---------------------------- Processing methods -----------------------------\n\n\t/** Initial window settings prior to setup().\n\t */\n\tpublic void settings()\n\t{ \n\t\tsize(1200,500);\n\n\t\t// Should work with all Processing 3 renderers.\n\t\t//size(1200, P2D);\n\t\t//size(1200,500, P3D);\n\t\t//size(1200,500, FX2D);\n\n\t\tpixelDensity(displayDensity());\t\t// Use platform's maximum display density.\n\t}\n\n\t/** Sets up the chart and fonts.\n\t */\n\tpublic void setup()\n\t{ \n\t\tsketchyFont = loadFont(\"HumorSans-18.vlw\");\n\t\tnormalFont = createFont(\"sansSerif\",14);\n\t\n\t\ttextFont(isHandy ? sketchyFont:normalFont);\n\t\t\n\t\tisHandy = true;\n\t\tshowXAxis = true;\n\t\tshowYAxis = true;\n\t\ttranspose = false;\n\t\tuseLog = false;\n\n\t\t// Handy appearance.\n\t\th = new HandyRenderer(this);\n\t\th.setFillGap(1.5f);\n\n\t\t// Data to show in charts.\n\t\tfloat[] barData = new float[] {0.21235f, 0.5f, 1, 2, 4, 8, 16, 32, 64, 128, 256, 512, 1024, 2048};\n\t\tfloat[] xData = new float[]{2,4,6,8,12,14,15,16,23};\n\t\tfloat[] yData = new float[]{6.0f,7.2f,5.8f,4.3f,2.1f,3.5f,6.8f,6.2f,5.8f};\n\t\tfloat[] sizeData = new float[]{1,10,4,20,13,6,2,8,6};\n\n\t\t// Bar chart.\n\t\tchart1 = new BarChart(this);\n\t\tchart1.setRenderer(DrawableFactory.createHandyRenderer(h));\n\t\tchart1.setData(barData);\n\t\tchart1.showValueAxis(showYAxis);\n\t\tchart1.setValueFormat(\"###,###.####\");\n\t\tchart1.showCategoryAxis(showXAxis);\n\t\tchart1.transposeAxes(transpose);\n\t\tchart1.setBarColour(barData,ColourTable.getPresetColourTable(ColourTable.GREENS, -1000, 1000));\n\t\tchart1.setBarLabels(new String[] {\"Item 1\",\"Item 2\",\"Item 3\",\"Item 4\",\"Item 5\",\"Item 6\",\"Item 7\",\"Item 8\",\"Item 9\",\"Item 10\",\"Item 11\",\"Item 12\",\"Item 13\", \"Item 14\"});\n\t\tchart1.setBarGap(barGap);\n\n\t\t// Line chart.\n\t\tchart2 = new XYChart(this);\n\t\tchart2.setShowEdge(true);\n\t\tchart2.setRenderer(DrawableFactory.createHandyRenderer(h)); \n\t\tchart2.setData(xData, yData);\n\t\tchart2.setMinY(0);\n\t\tchart2.setMaxY(10);\n\t\tchart2.showXAxis(showXAxis);\n\t\tchart2.showYAxis(showYAxis);\n\t\tchart2.setXFormat(\"###,###.###\");\n\t\tchart2.setPointSize(sizeData, 32);\n\t\tchart2.setLineWidth(5f);\n\t\tchart2.setXAxisLabel(\"This is the x-axis\");\n\t\tchart2.setYAxisLabel(\"This is the y-axis\");\n\t\tchart2.setAxisColour(color(255));\n\t\tchart2.setAxisValuesColour(color(128,100,100));\n\t\tchart2.setAxisLabelColour(color(255,200,200));\n\t\tchart2.setPointColour(xData, ColourTable.getPresetColourTable(ColourTable.REDS,0,23));\n\t\tchart2.setLineColour(color(200,100,100));\n\t}\n\n\t/** Draws two charts.\n\t */\n\tpublic void draw()\n\t{ \n\t\tbackground(255);\n\t\ttextFont(isHandy ? sketchyFont:normalFont);\n\t\t\n strokeWeight(1);\n textSize(10);\n chart1.draw(1,1,width*.5f-2,height-2);\n \n fill(0);\n textSize(18);\n rect(width*.5f,0,width*.5f,height);\n chart2.draw(width*.5f+1,1,width*.5f-2,height-2);\n\n\t\tnoLoop();\n\t}\n\n\t/** Responds to key presses to control appearance of the charts.\n\t */\n\t@Override\n\tpublic void keyPressed()\n\t{\n\t\tif ((key =='h') || (key == 'H'))\n\t\t{\n\t\t\tisHandy = !isHandy;\n\t\t\th.setIsHandy(isHandy);\n\t\t\tloop();\n\t\t}\n\t\telse if ((key == 'l') || (key == 'L'))\n\t\t{\n\t\t\tuseLog = !useLog;\n\t\t\tchart1.setLogValues(useLog);\n\t\t\tchart2.setLogX(useLog);\n\t\t\tchart2.setLogY(useLog);\n\t\t\tloop();\n\t\t}\n\t\tif ((key == 't') || (key == 'T'))\n\t\t{\n\t\t\ttranspose = !transpose;\n\t\t\tchart1.transposeAxes(transpose);\n\t\t\tloop();\n\t\t}\n\t\tif ((key == 'x') || (key == 'X'))\n\t\t{\n\t\t\tshowXAxis = !showXAxis;\n\t\t\tchart1.showCategoryAxis(showXAxis);\n\t\t\tchart2.showXAxis(showXAxis);\n\t\t\tloop();\n\t\t}\n\t\telse if ((key == 'y') || (key == 'Y'))\n\t\t{\n\t\t\tshowYAxis = !showYAxis;\n\t\t\tchart1.showValueAxis(showYAxis);\n\t\t\tchart2.showYAxis(showYAxis);\n\t\t\tloop();\n\t\t}\n\n\t\tif (key == CODED)\n\t\t{\n\t\t\tif (keyCode == PConstants.LEFT)\n\t\t\t{\n\t\t\t\tif (barGap > 0)\n\t\t\t\t{\n\t\t\t\t\tbarGap--;\n\t\t\t\t\tchart1.setBarGap(barGap);\n\t\t\t\t\tloop();\n\t\t\t\t}\n\t\t\t}\n\t\t\telse if (keyCode == PConstants.RIGHT)\n\t\t\t{\n\t\t\t\tif (barGap < width)\n\t\t\t\t{\n\t\t\t\t\tbarGap++;\n\t\t\t\t\tchart1.setBarGap(barGap);\n\t\t\t\t\tloop();\n\t\t\t\t}\n\t\t\t}\n\t\t\telse if (keyCode == PConstants.DOWN)\n\t\t\t{\n\t\t\t\tif (barPad > 0)\n\t\t\t\t{\n\t\t\t\t\tbarPad--;\n\t\t\t\t\tchart1.setBarPadding(barPad);\n\t\t\t\t\tloop();\n\t\t\t\t}\n\t\t\t}\n\t\t\telse if (keyCode == PConstants.UP)\n\t\t\t{\n\t\t\t\tif (barPad < width)\n\t\t\t\t{\n\t\t\t\t\tbarPad++;\n\t\t\t\t\tchart1.setBarPadding(barPad);\n\t\t\t\t\tloop();\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\t}\n}" }, { "path": "Handy/src/org/gicentre/tests/CircleTest.java", "content": "package org.gicentre.tests;\n\nimport org.gicentre.handy.HandyRenderer;\nimport org.gicentre.utils.move.ZoomPan;\n\nimport processing.core.PApplet;\nimport processing.core.PConstants;\n\n//*****************************************************************************************\n/** Draws a set of randomly positioned ellipses with sketchy shaded interiors. Can zoom and\n * pan by dragging mouse; 'R' to reset zoom/pan. 'H' to toggle sketchy rendering. Left and\n * right arrows to change angle of hachures. Up and down arrows to change degree of \n * sketchiness.\n * A set of very small circles are drawn which should not be visible in the sketchy view\n * but present as points in the non-sketchy view. \n * @author Jo Wood, giCentre, City University London.\n * @version 2.0, 2nd April, 2016.\n */ \n// *****************************************************************************************\n\n/* This file is part of Handy sketchy drawing library. Handy is free software: you can \n * redistribute it and/or modify it under the terms of the GNU Lesser General Public License\n * as published by the Free Software Foundation, either version 3 of the License, or (at your\n * option) any later version.\n * \n * Handy is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY;\n * without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. \n * See the GNU Lesser General Public License for more details.\n * \n * You should have received a copy of the GNU Lesser General Public License along with this\n * source code (see COPYING.LESSER included with this source code). If not, see \n * http://www.gnu.org/licenses/.\n */\n\npublic class CircleTest extends PApplet \n{\n\t// ------------------------------ Starter method ------------------------------- \n\n\t/** Creates a simple application to test handy line drawing.\n\t * @param args Command line arguments (ignored). \n\t */\n\tpublic static void main(String[] args)\n\t{ \n\t\tPApplet.main(new String[] {\"org.gicentre.tests.CircleTest\"});\n\t}\n\n\t// ----------------------------- Object variables ------------------------------\n\n\tprivate HandyRenderer h;\t\t\t// Does the sketchy rendering.\n\tprivate ZoomPan zoomer;\t\t\t\t// For zooming and panning.\n\tprivate float angle;\t\t\t\t// Hachure angle.\n\tprivate boolean isHandy;\t\t\t// Toggles handy rendering on and off.\n\tprivate float roughness;\t\t\t// Degree of sketchiness.\n\t\n\t// ---------------------------- Processing methods -----------------------------\n\n\t/** Initial window settings prior to setup().\n\t */\n\tpublic void settings()\n\t{ \n\t\tsize(800,800);\n\t\t\n\t\t// Should work with all Processing 3 renderers.\n\t\t// size(800,800, P2D);\n\t\t// size(800,800, P3D);\n\t\t// size(800,800, FX2D);\n\t\t\n\t\tpixelDensity(displayDensity());\t\t// Use platform's maximum display density.\n\t}\n\t\n\t/** Sets up the sketch.\n\t */\n\tpublic void setup()\n\t{ \n\t\tzoomer = new ZoomPan(this);\n\t\tangle = -45;\n\t\troughness = 1;\n\t\tisHandy = true;\n\t\th = new HandyRenderer(this);\n\t\th.setHachureAngle(angle);\n\t\th.setHachurePerturbationAngle(5);\n\t\th.setIsHandy(isHandy);\n\t\th.setRoughness(roughness);\n\t}\n\t\n\t\n\t/** Draws some sketchy circles.\n\t */\n\tpublic void draw()\n\t{\n\t\tbackground(255);\n\t\tzoomer.transform();\n\t\tstroke(80);\n\t\tstrokeWeight(1f);\n\t\tnoFill();\n\t\t\n\t\th.setSeed(1234);\n\t\trandomSeed(1245);\n\t\tint numCircles = 40;\n\t\t\n\t\tfor (int i=0; i0)\n\t\t\t{\n\t\t\t\ttext((char)('A'+i),cx-10,10+(i+0.4f)*barWidth);\n\t\t\t}\n\t\t\telse\n\t\t\t{\n\t\t\t\ttext((char)('A'+i),cx+10,10+(i+0.4f)*barWidth);\n\t\t\t}\n\t\t}\n\t\t\n\t\t// Draw scale\n\t\tstroke(180);\n\t\tfill(80);\n\t\th.line(cx-250, height-10, cx+100, height-10);\n\t\t\n\t\ttextAlign(CENTER,BOTTOM);\n\t\ttextSize(isHandy?20:14);\n\t\tfor (int x=-250; x<=100; x+=50)\n\t\t{\n\t\t\ttext(x,cx+x,height-15);\n\t\t\th.line(cx+x, height-10, cx+x, height-15);\n\t\t}\n\t\t\t\t\n\t\tnoLoop();\n\t}\n\t\n\t/** Responds to key presses to alter appearance of sketch shapes.\n\t */\n\t@Override\n\tpublic void keyPressed()\n\t{\n\t\tif ((key =='h') || (key == 'H'))\n\t\t{\n\t\t\tisHandy = !isHandy;\n\t\t\th.setIsHandy(isHandy);\n\t\t\tloop();\n\t\t}\n\t\telse if (key == '1')\n\t\t{\n\t\t\tsWeight = 1f;\n\t\t\tloop();\n\t\t}\n\t\telse if (key == '2')\n\t\t{\n\t\t\tsWeight = 1.5f;\n\t\t\tloop();\n\t\t}\n\t\telse if (key == '3')\n\t\t{\n\t\t\tsWeight = 2.5f;\n\t\t\tloop();\n\t\t}\n\t\telse if ((key == 's') || (key == 'S'))\n\t\t{\n\t\t\tuseSecondary = !useSecondary;\n\t\t\th.setUseSecondaryColour(useSecondary);\n\t\t\tloop();\n\t\t}\n\t}\n}\n" }, { "path": "Handy/src/org/gicentre/tests/HandyRecorder2dTest.java", "content": "package org.gicentre.tests;\n\nimport org.gicentre.handy.HandyRecorder;\nimport org.gicentre.handy.HandyRenderer;\n\nimport processing.core.PApplet;\nimport processing.core.PConstants;\n\n// *****************************************************************************************\n/** Tests the use of the HandyGraphics context to allow sketchy graphics without explicitly\n * calling methods in the HandyRenderer.\n * @author Jo Wood, giCentre, City University London.\n * @version 2.0, 3rd April, 2016\n */ \n// *****************************************************************************************\n\n/* This file is part of Handy sketchy drawing library. Handy is free software: you can \n * redistribute it and/or modify it under the terms of the GNU Lesser General Public License\n * as published by the Free Software Foundation, either version 3 of the License, or (at your\n * option) any later version.\n * \n * Handy is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY;\n * without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. \n * See the GNU Lesser General Public License for more details.\n * \n * You should have received a copy of the GNU Lesser General Public License along with this\n * source code (see COPYING.LESSER included with this source code). If not, see \n * http://www.gnu.org/licenses/.\n */\n\npublic class HandyRecorder2dTest extends PApplet \n{\n\t// ------------------------------ Starter method ------------------------------- \n\n\t/** Creates a simple application to test handy line drawing.\n\t * @param args Command line arguments (ignored). \n\t */\n\tpublic static void main(String[] args)\n\t{ \n\t\tPApplet.main(new String[] {\"org.gicentre.tests.HandyRecorder2dTest\"});\n\t}\n\n\t// ----------------------------- Object variables ------------------------------\n\n\tprivate HandyRenderer h;\t\t\t// Does the sketchy rendering.\n\tprivate HandyRecorder handyRec;\t\t// Graphics context in which to render.\n\tprivate boolean isHandy;\t\t\t// Toggles handy rendering on and off.\n\tprivate float roughness;\t\t\t// Degree of sketchiness.\n\n\t// ---------------------------- Processing methods -----------------------------\n\n\t/** Initial window settings prior to setup().\n\t */\n\tpublic void settings()\n\t{ \n\t\t//size(800,800);\n\n\t\t// Should work with all Processing 3 renderers.\n\t\t// size(800,800, P2D);\n\t\tsize(800,800, P3D);\n\t\t// size(800,800, FX2D);\n\n\t\tpixelDensity(displayDensity());\t\t// Use platform's maximum display density.\n\t}\n\n\t/** Sets up the sketch.\n\t */\n\tpublic void setup()\n\t{ \n\t\th = new HandyRenderer(this);\n\t\th.setFillGap(2f);\n\t\thandyRec = new HandyRecorder(h);\n\t\tisHandy = true;\n\t\troughness = 1;\n\t}\n\n\t/** Draws a range of graphics objects using a HandyGraphics object.\n\t */\n\t@Override\n\tpublic void draw()\n\t{\n\t\tbackground(255);\n\t\tstrokeWeight(2);\n\t\tstroke(0);\n\t\t\n\t\th.setSeed(1224);\n\t\th.setRoughness(roughness);\n\t\t\n\t\t// Anything drawn before turning on the handy recorder should appear as normal\n\t\tline(mouseX,mouseY-100,mouseX,mouseY+100);\n\t\tline(mouseX-100,mouseY,mouseX+100,mouseY);\n\t\tnoFill();\n\t\tstrokeWeight(0.5f);\n\t\tellipse(mouseX,mouseY,200,200);\n\t\t\t\t\n\t\t// Turn on Handy rendering at the start of each draw cycle.\n\t\tif (isHandy)\n\t\t{\n\t\t\tbeginRecord(handyRec);\n\t\t}\n\t\tpushMatrix();\n\t\trotate(radians(-10));\n\t\ttranslate(0,100);\n\t\tscale(1.5f);\n\t\tfill(100,100);\n\t\t\n\t\tline(10, 10, 200, 200);\n\t\tellipse(100,100,20,20);\n\t\trect(150,150,30,30);\n\t\ttriangle(40, 20, 20, 40, 60, 30);\n\t\tbeginShape();\n\t\tvertex(180,30);\n\t\tvertex(200,30);\n\t\tvertex(200,10);\n\t\tvertex(210,10);\n\t\tvertex(210,30);\n\t\tvertex(230,30);\n\t\tvertex(230,40);\n\t\tvertex(210,40);\n\t\tvertex(210,60);\n\t\tvertex(200,60);\n\t\tvertex(200,40);\n\t\tvertex(180,40);\n\t\tendShape(CLOSE);\n\t\t\n\t\t// Some curved lines and shapes in a different style.\n\t\tpushStyle();\n\t\t\n\t\tnoFill();\n\t\tstrokeWeight(2);\n\t\tstroke(255, 102, 0);\n\t\tcurve(405, 26, 405, 26, 273, 24, 273, 61);\n\t\tcurve(405, 26, 273, 24, 273, 61, 415, 65); \n\t\tcurve(273, 24, 273, 61, 415, 65, 415, 65);\n\t\t\t\t\n\t\tfill(255, 102, 0);\n\t\tbeginShape();\n\t\tcurveVertex(384, 191);\n\t\tcurveVertex(384, 191);\n\t\tcurveVertex(368, 119);\n\t\tcurveVertex(321, 117);\n\t\tcurveVertex(332, 200);\n\t\tcurveVertex(332, 200);\n\t\tvertex(384, 191);\t\t\n\t\tendShape(CLOSE);\n\t\t\n\t\tpopStyle();\n\t\t\n\t\t\n\t\t//examples from http://processing.org/reference/beginShape_.html\n\t\t\n\t\tpushMatrix();\n\t\ttranslate(0,200);\n\t\tbeginShape();\n\t\tvertex(30, 20);\n\t\tvertex(85, 20);\n\t\tvertex(85, 75);\n\t\tvertex(30, 75);\n\t\tendShape(CLOSE);\n\n\t\ttranslate(100,0);\n\t\tbeginShape(POINTS);\n\t\tvertex(30, 20);\n\t\tvertex(85, 20);\n\t\tvertex(85, 75);\n\t\tvertex(30, 75);\n\t\tendShape();\n\n\t\ttranslate(100,0);\n\t\tbeginShape(LINES);\n\t\tvertex(30, 20);\n\t\tvertex(85, 20);\n\t\tvertex(85, 75);\n\t\tvertex(30, 75);\n\t\tendShape();\n\n\t\ttranslate(100,0);\n\t\tnoFill();\n\t\tbeginShape();\n\t\tvertex(30, 20);\n\t\tvertex(85, 20);\n\t\tvertex(85, 75);\n\t\tvertex(30, 75);\n\t\tendShape();\n\n\t\ttranslate(-300,100);\n\t\tnoFill();\n\t\tbeginShape();\n\t\tvertex(30, 20);\n\t\tvertex(85, 20);\n\t\tvertex(85, 75);\n\t\tvertex(30, 75);\n\t\tendShape(CLOSE);\n\n\t\ttranslate(100,0);\n\t\tfill(200,100,100);\n\t\tbeginShape(TRIANGLES);\n\t\tvertex(30, 75);\n\t\tvertex(40, 20);\n\t\tvertex(50, 75);\n\t\tvertex(60, 20);\n\t\tvertex(70, 75);\n\t\tvertex(80, 20);\n\t\tendShape();\n\n\t\ttranslate(100,0);\n\t\tbeginShape(TRIANGLE_STRIP);\n\t\tvertex(30, 75);\n\t\tvertex(40, 20);\n\t\tvertex(50, 75);\n\t\tvertex(60, 20);\n\t\tvertex(70, 75);\n\t\tvertex(80, 20);\n\t\tvertex(90, 75);\n\t\tendShape();\n\n\t\ttranslate(100,0);\n\t\tbeginShape(TRIANGLE_FAN);\n\t\tvertex(57.5f, 50);\n\t\tvertex(57.5f, 15); \n\t\tvertex(92, 50); \n\t\tvertex(57.5f, 85); \n\t\tvertex(22, 50); \n\t\tvertex(57.5f, 15); \n\t\tendShape();\n\n\t\ttranslate(-300,100);\n\t\tbeginShape(QUADS);\n\t\tvertex(30, 20);\n\t\tvertex(30, 75);\n\t\tvertex(50, 75);\n\t\tvertex(50, 20);\n\t\tvertex(65, 20);\n\t\tvertex(65, 75);\n\t\tvertex(85, 75);\n\t\tvertex(85, 20);\n\t\tendShape();\n\n\t\ttranslate(100,0);\n\t\tbeginShape(QUAD_STRIP); \n\t\tvertex(30, 20); \n\t\tvertex(30, 75); \n\t\tvertex(50, 20);\n\t\tvertex(50, 75);\n\t\tvertex(65, 20); \n\t\tvertex(65, 75); \n\t\tvertex(85, 20);\n\t\tvertex(85, 75); \n\t\tendShape();\n\n\t\ttranslate(100,0);\n\t\tbeginShape();\n\t\tvertex(20, 20);\n\t\tvertex(40, 20);\n\t\tvertex(40, 40);\n\t\tvertex(60, 40);\n\t\tvertex(60, 60);\n\t\tvertex(20, 60);\n\t\tendShape(CLOSE);\n\n\t\tpopMatrix();\t\t// End of scaling and translation.\n\t\t\n\t\tpopMatrix();\t\t// End of rotation\n\t\t\n\t\t// Small sketchy ellipse after transformations follows mouse position.\n\t\tstroke(0);\n\t\tfill(200,50,50,100);\n\t\tellipse(mouseX,mouseY,90,40);\n\t\t\n\t\t// Turn off handy rendering at the end of each draw cycle.\n\t\tif (isHandy)\n\t\t{\n\t\t\tendRecord();\n\t\t}\n\t\t\n\t\t// Any code following the turning off of the handy recorder should be unsketchy.\n\t\tfill(50,50,200,100);\n\t\tnoStroke();\n\t\tellipse(mouseX,mouseY,200,120);\n\t}\n\t\n\t/** Responds to key presses to control appearance of shapes.\n\t */\n\t@Override\n\tpublic void keyPressed()\n\t{\n\t\tif ((key =='h') || (key == 'H'))\n\t\t{\n\t\t\tisHandy = !isHandy;\n\t\t\th.setIsHandy(isHandy);\n\t\t}\n\t\t\n\t\tif (key == PConstants.CODED)\n\t\t{\n\t\t\tif (keyCode == PConstants.UP)\n\t\t\t{\n\t\t\t\troughness *= 1.1;\n\t\t\t}\n\t\t\telse if (keyCode == PConstants.DOWN)\n\t\t\t{\n\t\t\t\troughness *= 0.9;\n\t\t\t}\n\t\t}\n\t}\n}\n" }, { "path": "Handy/src/org/gicentre/tests/HandyRecorder3dTest.java", "content": "package org.gicentre.tests;\n\nimport org.gicentre.handy.HandyRecorder;\nimport org.gicentre.handy.HandyRenderer;\nimport org.gicentre.utils.FrameTimer;\n\nimport processing.core.PApplet;\nimport processing.core.PConstants;\n\n// *****************************************************************************************\n/** Test the handy recorder for 3d sketches. 'H' to toggle sketchy rendering, up and \n * down arrows to change degree of sketchiness.\n * @author Jo Wood, giCentre, City University London.\n * @version 2.0, 3rd April, 2016\n */ \n// *****************************************************************************************\n\n/* This file is part of Handy sketchy drawing library. Handy is free software: you can \n * redistribute it and/or modify it under the terms of the GNU Lesser General Public License\n * as published by the Free Software Foundation, either version 3 of the License, or (at your\n * option) any later version.\n * \n * Handy is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY;\n * without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. \n * See the GNU Lesser General Public License for more details.\n * \n * You should have received a copy of the GNU Lesser General Public License along with this\n * source code (see COPYING.LESSER included with this source code). If not, see \n * http://www.gnu.org/licenses/.\n */\n\npublic class HandyRecorder3dTest extends PApplet \n{\n\t// ------------------------------ Starter method ------------------------------- \n\n\t/** Creates a simple application to test handy line drawing.\n\t * @param args Command line arguments (ignored). \n\t */\n\tpublic static void main(String[] args)\n\t{ \n\t\tPApplet.main(new String[] {\"org.gicentre.tests.HandyRecorder3dTest\"});\n\t}\n\n\t// ----------------------------- Object variables ------------------------------\n\n\tprivate HandyRenderer h;\t\t\t// Does the sketchy rendering.\n\tprivate boolean isHandy;\t\t\t// Toggles sketchy rendering on and off\n\tprivate float roughness;\t\t\t// Degree of sketchiness.\n\tprivate HandyRecorder handyRec;\t\t// For sketchy rendering with normal processing commands.\n\tprivate FrameTimer timer;\t\t\t// For rendering speed reporting.\n\tprivate float fov;\t\t\t\t\t// Field of view of camera.\n\n\t// ---------------------------- Processing methods -----------------------------\n\n\t/** Initial window settings prior to setup().\n\t */\n\tpublic void settings()\n\t{ \n\t\tsize(800,600,P3D);\t\t\n\t\tpixelDensity(displayDensity());\t\t// Use platform's maximum display density.\n\t}\n\n\t/** Sets up the sketch.\n\t */\n\t@Override\n\tpublic void setup()\n\t{ \n\t\tnoStroke(); \n\t\troughness = 2;\n\t\tfov = PI/6;\n\t\ttimer = new FrameTimer();\n\n\t\th = new HandyRenderer(this);\n\t\th.setRoughness(roughness);\n\t\th.setFillGap(1);\n\t\thandyRec = new HandyRecorder(h);\n\t}\n\n\t/** Draws some 3d boxes that slowly ride and fall.\n\t */\n\t@Override\n\tpublic void draw()\n\t{\n\t\ttimer.displayFrameRate();\n\t\th.setSeed(1234);\t\t// To stop jittering.\n\n\t\tbeginRecord(handyRec);\n\n\t\t// Set up camera position first.\n\t\tbeginCamera();\n\t\tcamera();\n\t\trotateX(radians(65));\n\t\trotateZ(radians(25));\n\t\ttranslate(width*0.2f, -height*1.3f, -width*0.9f);\n\t\tendCamera();\n\t\t\n\t\trotateZ(radians(-mouseX));\t\t// Rotate view with mouse movement.\n\n\t\t// Perspective transformation.\n\t\tfloat cameraZ = (height/2f) / tan(fov/2f);\n\t\tperspective(fov, (float)(width)/(float)height, cameraZ/10f, cameraZ*10f);\n\n\t\t// Rendering style.\n\t\tbackground(255);\n\t\tstroke(0);\n\t\tstrokeWeight(3);\n\n\t\t// Set up lighting.\n\t\tlights();\n\t\tpointLight(51, 102, 126, 35, 40, 36);\n\t\tambientLight(10,10, 30);\n\t\tdirectionalLight(25, 50, 25, 0.1f, 0.1f, -1);\n\t\tspotLight(60, 0, 0, 80, 20, 40, -1, 0, 0, PI/2, 2);\n\t\tlightFalloff(1f, 0.001f, 0f);\n\t\tlightSpecular(204, 204, 204);\n\t\t\n\t\t// Base mat.\n\t\tfill(70);\n\t\tnoFill();\n\t\tbox(950,950,0);\n\t\tfill(255);\n\t\t\n\t\t// Draw a grid of moving buildings.\n\t\tfor (int y=-400; y<=400; y+=100)\n\t\t{\n\t\t\tfor (int x=-400; x<=400; x+=100)\n\t\t\t{\n\t\t\t\tfloat d = 1000*pow(noise(0.01f*x, 0.01f*y,millis()*0.00002f), 5);\n\t\t\t\tpushMatrix();\n\t\t\t\ttranslate(x,y,d/2);\n\t\t\t\tbox(80, 80, d);\n\t\t\t\tpopMatrix();\n\t\t\t}\n\t\t}\n\n\t\tendRecord();\t// End of sketchy recording.\n\n\t\t// Some perspective lines in a non sketchy style\n\t\tstrokeWeight(0.5f);\n\t\tstroke(100,150,255);\n\t\t\n\t\tline(0,0,0,9999999,0,0);\n\t\tline(0,-400,0,9999999,-400,0);\n\t\tline(0,400,0,9999999,400,0);\n\t\t\n\t\tline(0,0,0,-9999999,0,0);\n\t\tline(0,-400,0,-9999999,-400,0);\n\t\tline(0,400,0,-9999999,400,0);\n\t\t\n\t\tline(0,0,0,0,9999999,0);\n\t\tline(-400,0,0,-400,9999999,0);\n\t\tline(400,0,0,400,9999999,0);\n\t\t\n\t\tline(0,0,0,0,-9999999,0);\n\t\tline(-400,0,0,-400,-9999999,0);\n\t\tline(400,0,0,400,-9999999,0);\n\t\t\n\t}\n\n\t/** Responds to key presses to alter appearance of sketch shapes.\n\t */\n\t@Override\n\tpublic void keyPressed()\n\t{\n\t\tif ((key =='h') || (key =='H'))\n\t\t{\n\t\t\tisHandy = !isHandy;\n\t\t\th.setIsHandy(isHandy);\n\t\t}\n\n\t\tif (key == PConstants.CODED)\n\t\t{\n\t\t\tif (keyCode == PConstants.UP)\n\t\t\t{\n\t\t\t\troughness *= 1.1;\n\t\t\t\th.setRoughness(roughness);\n\t\t\t}\n\t\t\telse if (keyCode == PConstants.DOWN)\n\t\t\t{\n\t\t\t\troughness *= 0.9;\n\t\t\t\th.setRoughness(roughness);\n\t\t\t}\n\t\t\telse if (keyCode == PConstants.LEFT)\n\t\t\t{\n\t\t\t\tfov *= 0.9;\n\t\t\t\t\n\t\t\t}\n\t\t\telse if (keyCode == PConstants.RIGHT)\n\t\t\t{\n\t\t\t\tfov *= 1.1;\n\t\t\t}\n\t\t}\n\t}\n}" }, { "path": "Handy/src/org/gicentre/tests/Line3dTest.java", "content": "package org.gicentre.tests;\n\nimport org.gicentre.handy.HandyRenderer;\n\nimport processing.core.PApplet;\nimport processing.core.PConstants;\n\n// *****************************************************************************************\n/** Simple sketch to test handy 3d line drawing. 'H' to toggle sketchy rendering, up and \n * down arrows to change degree of sketchiness. Left and right arrows to change the vertex \n * overshoot. Move mouse to rotate cube.\n * @author Jo Wood, giCentre, City University London.\n * @version 2.0, 3rd April, 2016\n */ \n// *****************************************************************************************\n\n/* This file is part of Handy sketchy drawing library. Handy is free software: you can \n * redistribute it and/or modify it under the terms of the GNU Lesser General Public License\n * as published by the Free Software Foundation, either version 3 of the License, or (at your\n * option) any later version.\n * \n * Handy is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY;\n * without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. \n * See the GNU Lesser General Public License for more details.\n * \n * You should have received a copy of the GNU Lesser General Public License along with this\n * source code (see COPYING.LESSER included with this source code). If not, see \n * http://www.gnu.org/licenses/.\n */\n\npublic class Line3dTest extends PApplet \n{\n\t// ------------------------------ Starter method ------------------------------- \n\n\t/** Creates a simple application to test handy line drawing.\n\t * @param args Command line arguments (ignored). \n\t */\n\tpublic static void main(String[] args)\n\t{ \n\t\tPApplet.main(new String[] {\"org.gicentre.tests.Line3dTest\"});\n\t}\n\n\t// ----------------------------- Object variables ------------------------------\n\n\tprivate HandyRenderer h;\t\t\t// Does the sketchy rendering.\n\tprivate boolean isHandy;\t\t\t// Toggles sketchy rendering on and off\n\tprivate float roughness;\t\t\t// Degree of sketchiness.\n\tprivate float overshoot;\t\t\t// Degree of vertex overshoot.\n\tprivate float xmag, ymag = 0;\t\t// Rotation parameters.\n\tprivate float newXmag, newYmag = 0; \n\n\t// ---------------------------- Processing methods -----------------------------\n\n\t/** Initial window settings prior to setup().\n\t */\n\tpublic void settings()\n\t{ \n\t\tsize(640,360,P3D);\t\t\n\t\tpixelDensity(displayDensity());\t\t// Use platform's maximum display density.\n\t}\n\t\n\t/** Sets up the sketch.\n\t */\n\t@Override\n\tpublic void setup()\n\t{ \n\t\tnoStroke(); \n\t\troughness = 1;\n\t\tovershoot = 1.1f;\n\t\th = new HandyRenderer(this);\n\t\th.setRoughness(roughness);\n\t}\n\n\t/** Draws some sketchy 3d lines.\n\t */\n\t@Override\n\tpublic void draw()\n\t{\n\t\tbackground(255);\n\t\th.setSeed(1969);\n\t\tfloat unitLen = 100;\n\n\t\tpushMatrix(); \n\n\t\ttranslate(width/2, height/2, -30); \n\n\t\tnewXmag = mouseX/(float)(width) * PConstants.TWO_PI;\n\t\tnewYmag = mouseY/(float)(height) * PConstants.TWO_PI;\n\n\t\tfloat diff = xmag-newXmag;\n\t\tif (abs(diff) > 0.01) \n\t\t{ \n\t\t\txmag -= diff/4.0; \n\t\t}\n\n\t\tdiff = ymag-newYmag;\n\t\tif (abs(diff) > 0.01) \n\t\t{ \n\t\t\tymag -= diff/4.0; \n\t\t}\n\n\t\trotateX(-ymag); \n\t\trotateY(-xmag); \n\n\n\t\tstroke(50,50,200,180);\n\t\tstrokeWeight(1);\n\t\t\t\t\n\t\tline(-unitLen, unitLen, unitLen, unitLen, unitLen, unitLen);\n\t\tline( unitLen, unitLen, unitLen, unitLen, -unitLen, unitLen);\n\t\tline( unitLen, -unitLen, unitLen,-unitLen, -unitLen, unitLen);\n\t\tline(-unitLen, -unitLen, unitLen,-unitLen, unitLen, unitLen);\n\n\t\tline( unitLen, unitLen, unitLen, unitLen, unitLen, -unitLen);\n\t\tline( unitLen, unitLen, -unitLen, unitLen, -unitLen, -unitLen);\n\t\tline( unitLen, -unitLen, -unitLen, unitLen, -unitLen, unitLen);\n\n\t\tline( unitLen, unitLen, -unitLen,-unitLen, unitLen, -unitLen);\n\t\tline(-unitLen, unitLen, -unitLen,-unitLen, -unitLen, -unitLen);\n\t\tline(-unitLen, -unitLen, -unitLen, unitLen, -unitLen, -unitLen);\n\n\t\tline(-unitLen, unitLen, -unitLen,-unitLen, unitLen, unitLen);\n\t\tline(-unitLen, -unitLen, unitLen,-unitLen, -unitLen, -unitLen);\n\t\t\n\t\tstroke(0);\n\t\tstrokeWeight(2);\n\t\t\n\t\th.line(-unitLen*overshoot, unitLen, unitLen, unitLen*overshoot, unitLen, unitLen);\n\t\th.line( unitLen, unitLen*overshoot, unitLen, unitLen, -unitLen*overshoot, unitLen);\n\t\th.line( unitLen*overshoot, -unitLen, unitLen,-unitLen*overshoot, -unitLen, unitLen);\n\t\th.line(-unitLen, -unitLen*overshoot, unitLen,-unitLen, unitLen*overshoot, unitLen);\n\n\t\th.line( unitLen, unitLen, unitLen*overshoot, unitLen, unitLen, -unitLen*overshoot);\n\t\th.line( unitLen, unitLen*overshoot, -unitLen, unitLen, -unitLen*overshoot, -unitLen);\n\t\th.line( unitLen, -unitLen, -unitLen*overshoot, unitLen, -unitLen, unitLen*overshoot);\n\n\t\th.line( unitLen*overshoot, unitLen, -unitLen,-unitLen*overshoot, unitLen, -unitLen);\n\t\th.line(-unitLen, unitLen*overshoot, -unitLen,-unitLen, -unitLen*overshoot, -unitLen);\n\t\th.line(-unitLen*overshoot, -unitLen, -unitLen, unitLen*overshoot, -unitLen, -unitLen);\n\n\t\th.line(-unitLen, unitLen, -unitLen*overshoot,-unitLen, unitLen, unitLen*overshoot);\n\t\th.line(-unitLen, -unitLen, unitLen*overshoot,-unitLen, -unitLen, -unitLen*overshoot);\n\n\t\tpopMatrix(); \n\t}\n\n\t/** Responds to key presses to alter appearance of sketch shapes.\n\t */\n\t@Override\n\tpublic void keyPressed()\n\t{\n\t\tif ((key =='h') || (key == 'H'))\n\t\t{\n\t\t\tisHandy = !isHandy;\n\t\t\th.setIsHandy(isHandy);\n\t\t}\n\n\t\tif (key == PConstants.CODED)\n\t\t{\n\t\t\tif (keyCode == PConstants.UP)\n\t\t\t{\n\t\t\t\troughness *= 1.1;\n\t\t\t\th.setRoughness(roughness);\n\t\t\t}\n\t\t\telse if (keyCode == PConstants.DOWN)\n\t\t\t{\n\t\t\t\troughness *= 0.9;\n\t\t\t\th.setRoughness(roughness);\n\t\t\t}\n\t\t\telse if ((keyCode == PConstants.LEFT) && (overshoot > 1))\n\t\t\t{\n\t\t\t\tovershoot *= 0.99;\n\t\t\t}\n\t\t\telse if (keyCode == PConstants.RIGHT)\n\t\t\t{\n\t\t\t\tovershoot *= 1.01;\n\t\t\t}\n\t\t}\n\t}\n}" }, { "path": "Handy/src/org/gicentre/tests/LineTest.java", "content": "package org.gicentre.tests;\n\nimport org.gicentre.handy.HandyRenderer;\nimport org.gicentre.utils.move.*;\t\t\t\t// For zooming.\n\nimport processing.core.PApplet;\nimport processing.core.PConstants;\nimport processing.core.PVector;\n\n// *****************************************************************************************\n/** Simple sketch to test handy line drawing by drawing three parallel sketchy lines with \n * the central one on top of a non-sketchy line. H key toggles sketchy rendering on or off.\n * Left and right arrow keys control the degree of sketchiness. Zoom and pan by dragging \n * the mouse, R to reset view.\n * @author Jo Wood, giCentre, City University London.\n * @version 2.0, 3rd April, 2016.\n */ \n// *****************************************************************************************\n\n/* This file is part of Handy sketchy drawing library. Handy is free software: you can \n * redistribute it and/or modify it under the terms of the GNU Lesser General Public License\n * as published by the Free Software Foundation, either version 3 of the License, or (at your\n * option) any later version.\n * \n * Handy is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY;\n * without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. \n * See the GNU Lesser General Public License for more details.\n * \n * You should have received a copy of the GNU Lesser General Public License along with this\n * source code (see COPYING.LESSER included with this source code). If not, see \n * http://www.gnu.org/licenses/.\n */\n\npublic class LineTest extends PApplet \n{\n\t// ------------------------------ Starter method ------------------------------- \n\n\t/** Creates a simple application to test handy line drawing.\n\t * @param args Command line arguments (ignored). \n\t */\n\tpublic static void main(String[] args)\n\t{ \n\t\tPApplet.main(new String[] {\"org.gicentre.tests.LineTest\"});\n\t}\n\n\t// ----------------------------- Object variables ------------------------------\n\n\tprivate HandyRenderer h;\t\t\t// Does the sketchy rendering.\n\tprivate ZoomPan zoomer;\t\t\t\t// For zooming and panning.\n\tprivate boolean isHandy;\t\t\t// Toggles handy rendering on and off.\n\tprivate float roughness;\t\t\t// Degree of sketchiness.\n\t\t\t\n\t// ---------------------------- Processing methods -----------------------------\n\n\t/** Initial window settings prior to setup().\n\t */\n\t@Override\n\tpublic void settings()\n\t{ \n\t\tsize(600,200);\n\t\t\n\t\t// Should work with all Processing 3 renderers.\n\t\t// size(600,200, P2D);\n\t\t// size(600,200, P3D);\n\t\t// size(600,200, FX2D);\n\t\t\n\t\tpixelDensity(displayDensity());\t\t// Use platform's maximum display density.\n\t}\n\t\n\t/** Sets up the sketch.\n\t */\n\t@Override\n\tpublic void setup()\n\t{ \n\t\tzoomer = new ZoomPan(this);\n\t\t\n\t\tisHandy = true;\n\t\th = new HandyRenderer(this);\n\t\th.setIsHandy(isHandy);\n\t\troughness = 1;\n\t\th.setRoughness(roughness);\n\t}\n\t\n\t\n\t/** Draws three parallel lines.\n\t */\n\t@Override\n\tpublic void draw()\n\t{\n\t\tbackground(255);\n\t\tzoomer.transform();\n\t\t\t\n\t\tPVector p1 = new PVector(100,100);\n\t\tPVector p2 = new PVector(width-100,height-100);\n\t\t\n\t\t// Draw guides for middle line\n\t\tpushStyle();\n\t\tstrokeWeight(0.3f);\n\t\tstroke(150,0,0);\n\t\tfloat radius = 4*roughness;\n\t\t\n\t\tellipse(p1.x,p1.y,radius,radius);\n\t\tellipse(p2.x,p2.y,radius,radius);\n\t\tline(p1.x,p1.y,p2.x,p2.y);\n\t\t\n\t\tpopStyle();\n\t\t\n\t\th.line(p1.x,p1.y-50,p2.x,p2.y-50);\t\n\t\th.line(p1.x,p1.y,p2.x,p2.y);\n\t\th.line(p1.x,p1.y+50,p2.x,p2.y+50);\n\n\t\tnoLoop();\n\t}\n\t\t\n\t\t\n\t/** Toggles sketchiness, resets zoomer and re-renders image according to the key pressed and\n\t * changes the roughness in response to the left and right arrow keys.\n\t */\n\t@Override\n\tpublic void keyPressed()\n\t{\n\t\tif ((key =='h') || (key =='H'))\n\t\t{\n\t\t\tisHandy = !isHandy;\n\t\t\th.setIsHandy(isHandy);\n\t\t\tloop();\n\t\t}\n\t\telse if ((key =='r') || (key =='R'))\n\t\t{\n\t\t\tzoomer.reset();\n\t\t\tloop();\n\t\t}\n\t\telse if (key == ' ')\n\t\t{\n\t\t\tloop();\n\t\t}\n\t\t\n\t\tif (key == PConstants.CODED)\n\t\t{\n\t\t\tif (keyCode == PConstants.LEFT)\n\t\t\t{\n\t\t\t\troughness *= 0.9f;\n\t\t\t\th.setRoughness(roughness);\n\t\t\t\tloop();\n\t\t\t}\n\t\t\telse if (keyCode == PConstants.RIGHT)\n\t\t\t{\n\t\t\t\troughness *= 1.1f;\n\t\t\t\th.setRoughness(roughness);\n\t\t\t\tloop();\n\t\t\t}\n\t\t}\n\t}\n\t\n\t/** Ensure sketch is redrawn when the mouse is dragged for zooming/panning.\n\t */\n\t@Override\n\tpublic void mouseDragged()\n\t{\n\t\tloop();\n\t}\n}\n" }, { "path": "Handy/src/org/gicentre/tests/OffscreenBufferTest.java", "content": "package org.gicentre.tests;\n\nimport java.util.ArrayList;\n\nimport org.gicentre.handy.HandyPresets;\nimport org.gicentre.handy.HandyRenderer;\nimport org.gicentre.handy.Simplifier;\n\nimport processing.core.PApplet;\nimport processing.core.PGraphics;\nimport processing.core.PVector;\n\n// *****************************************************************************************\n/** Simple mouse-controlled painting application to test line and polygon drawing and writing\n * to an offscreen buffer. Drag mouse to draw lines; shift-drag to draw polygons.\n * @author Jo Wood, giCentre, City University London.\n * @version 2.0, 3rd April, 2016.\n */ \n// *****************************************************************************************\n\n/* This file is part of Handy sketchy drawing library. Handy is free software: you can \n * redistribute it and/or modify it under the terms of the GNU Lesser General Public License\n * as published by the Free Software Foundation, either version 3 of the License, or (at your\n * option) any later version.\n * \n * Handy is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY;\n * without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. \n * See the GNU Lesser General Public License for more details.\n * \n * You should have received a copy of the GNU Lesser General Public License along with this\n * source code (see COPYING.LESSER included with this source code). If not, see \n * http://www.gnu.org/licenses/.\n */\n\n\npublic class OffscreenBufferTest extends PApplet \n{\n\t// ------------------------------ Starter method ------------------------------- \n\n\t/** Creates the paint program as an application.\n\t * @param args Command line arguments (ignored). \n\t */\n\tpublic static void main(String[] args)\n\t{ \n\t\tPApplet.main(new String[] {\"org.gicentre.tests.OffscreenBufferTest\"});\n\t}\n\n\t// ----------------------------- Object variables ------------------------------\n\n\tprivate HandyRenderer h;\n\tprivate Mark currentMark;\n\tprivate float roughness;\n\n\tprivate PGraphics pg;\t\t\t\t// Offscreen buffer.\n\t\n\t// ---------------------------- Processing methods -----------------------------\n\n\t/** Initial window settings prior to setup().\n\t */\n\t@Override\n\tpublic void settings()\n\t{ \n\t\tsize(1200,800);\n\t\t\n\t\t// Should work with all Processing 3 renderers.\n\t\t// size(1200,800, P2D);\n\t\t// size(1200,800, P3D);\n\t\t// size(1200,800, FX2D);\n\t\t\n\t\t// TODO: PROCESSING BUG IN OFFSCREEN BUFFER IN RETINA MODE PREVENTS THIS WORKING AT PIXEL DENSITY 2\n\t\t//pixelDensity(displayDensity());\t\t// Use platform's maximum display density.\n\t}\n\t\n\t/** Sets up the sketch.\n\t */\n\t@Override\n\tpublic void setup()\n\t{\n\t\t// Create the offscreen buffer into which accumulated drawing will placed.\n\t\tpg = createGraphics(width,height);\t\t\n\t\tpg.beginDraw();\n\t\tpg.background(255);\n\t\tpg.endDraw();\n\t\t\n\t\th = HandyPresets.createPencil(this);\n\t\tcurrentMark = new Mark(h);\n\t\troughness = 1;\n\t\th.setRoughness(roughness);\n\t}\n\n\t// ------------------------ Processing draw -------------------------\n\n\t/** Draws the user-generated lines and polygons.\n\t */\n\t@Override\n\tpublic void draw()\n\t{\n\t\tbackground(255);\n\t\t\n\t\th.setSeed(12345);\t\t// Stops jittering on redraw.\n\t\t\n\t\t// Draw accumulated image.\n\t\timage (pg,0,0);\n\n\t\t// Draw currently active shape on top of image.\n\t\tcurrentMark.draw();\n\n\t\tnoLoop();\n\t}\n\n\t/** Adds the current pointer location to the current shape when mouse is pressed.\n\t */\n\t@Override\n\tpublic void mousePressed()\n\t{\n\t\tcurrentMark.add(mouseX,mouseY); \n\t\tloop(); \n\t}\n\n\t/** Adds the current pointer location to the current shape when mouse is dragged.\n\t */\n\t@Override\n\tpublic void mouseDragged()\n\t{\n\t\tcurrentMark.add(mouseX,mouseY); \n\t\tloop(); \n\t}\n\n\t/** Stores the current shape when the mouse is released.\n\t */\n\t@Override\n\tpublic void mouseReleased()\n\t{\t\t\n\t\t// Add the active shape to the image buffer\n\t\th.setGraphics(pg);\n\t\tpg.beginDraw();\n\t\tcurrentMark.draw();\n\t\tpg.endDraw();\n\t\th.setGraphics(this.g);\n\t\t\n\t\t// Reset new shape.\n\t\tcurrentMark = new Mark(h);\n\t\tloop();\n\t}\n\n\t/** Responds to key pressed by allowing appearance of objects to be changed and line/polygon drawing to\n\t * be controlled with the shift key.\n\t */\n\t@Override\n\tpublic void keyPressed()\n\t{\t\t\n\t\tif (key==CODED)\n\t\t{\n\t\t\tif (keyCode == SHIFT)\n\t\t\t{ \n\t\t\t\tcurrentMark.setIsPolygon(true);\n\t\t\t\tloop();\n\t\t\t}\n\n\t\t\telse if (keyCode == LEFT)\n\t\t\t{\n\t\t\t\troughness *=0.9f;\n\t\t\t\th.setRoughness(roughness);\n\t\t\t\tprintln(\"Roughness down to \"+roughness);\n\t\t\t\tloop();\n\t\t\t}\n\t\t\telse if (keyCode == RIGHT)\n\t\t\t{\n\t\t\t\troughness *=1.1f;\n\t\t\t\th.setRoughness(roughness);\n\n\t\t\t\tprintln(\"Roughness up to \"+roughness);\n\t\t\t\tloop();\n\t\t\t}\n\t\t}\n\t}\n\n\t/** Completes the current polygon (if it is being drawn) on mouse release.\n\t */\n\t@Override\n\tpublic void keyReleased()\n\t{\n\t\tif (key==CODED)\n\t\t{\n\t\t\tif (keyCode == SHIFT)\n\t\t\t{ \n\t\t\t\tcurrentMark.setIsPolygon(false);\n\t\t\t\tloop();\n\t\t\t}\n\t\t}\n\t}\n\n\n\t// ----------------------------------- Nested classes -----------------------------------------\n\n\t// Represents a single graphical mark such as a line or polygon.\n\tprivate class Mark\n\t{\n\t\tprivate ArrayList coords;\n\t\tprivate float[] xCoords,yCoords;\n\t\tprivate int fillColour;\n\t\tprivate boolean isPolygon;\n\t\tprivate HandyRenderer handy;\n\n\n\t\tpublic Mark(HandyRenderer h)\n\t\t{\n\t\t\tthis.handy = h;\n\t\t\tcoords = new ArrayList();\n\t\t\tfillColour = color(80,30,30);\n\t\t\tisPolygon = false;\n\t\t}\n\n\n\t\tvoid add(float x, float y)\n\t\t{\n\t\t\tcoords.add(new PVector(x,y));\n\n\t\t\tSimplifier.simplify(coords,1);\n\t\t\txCoords = Simplifier.getSimplifiedX();\n\t\t\tyCoords = Simplifier.getSimplifiedY();\n\t\t}\n\n\t\tvoid setIsPolygon(boolean isPolygon)\n\t\t{\n\t\t\tthis.isPolygon = isPolygon;\n\t\t}\n\n\n\t\tvoid draw()\n\t\t{\n\t\t\tif (xCoords == null)\n\t\t\t{\n\t\t\t\treturn;\n\t\t\t}\n\n\t\t\tif (isPolygon)\n\t\t\t{\n\t\t\t\tfill(fillColour);\n\t\t\t\thandy.shape(xCoords,yCoords);\n\t\t\t}\n\t\t\telse\n\t\t\t{\n\t\t\t\thandy.polyLine(xCoords,yCoords);\n\t\t\t}\n\t\t}\n\t}\n}\n" }, { "path": "Handy/src/org/gicentre/tests/PDFAndSVGTest.java", "content": "package org.gicentre.tests;\n\nimport org.gicentre.handy.HandyRenderer;\n\nimport processing.core.PApplet;\n\n// *****************************************************************************************\n/** Simple sketch to draw a single circle in a handy style that can be saved as a PDF image\n * by pressing the 'P' key or SVG file with the 'S' key. Spacebar re-renders with a different\n * random perturbation.\n * @author Jo Wood, giCentre, City University London.\n * @version 2.0, 3rd April, 2016\n */ \n// *****************************************************************************************\n\n/* This file is part of Handy sketchy drawing library. Handy is free software: you can \n * redistribute it and/or modify it under the terms of the GNU Lesser General Public License\n * as published by the Free Software Foundation, either version 3 of the License, or (at your\n * option) any later version.\n * \n * Handy is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY;\n * without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. \n * See the GNU Lesser General Public License for more details.\n * \n * You should have received a copy of the GNU Lesser General Public License along with this\n * source code (see COPYING.LESSER included with this source code). If not, see \n * http://www.gnu.org/licenses/.\n */\n\npublic class PDFAndSVGTest extends PApplet \n{\n\t// ------------------------------ Starter method ------------------------------- \n\n\t/** Creates a simple application to test handy line drawing.\n\t * @param args Command line arguments (ignored). \n\t */\n\tpublic static void main(String[] args)\n\t{ \n\t\tPApplet.main(new String[] {\"org.gicentre.tests.PDFAndSVGTest\"});\n\t}\n\n\t// ----------------------------- Object variables ------------------------------\n\n\tprivate HandyRenderer h;\n\tprivate enum Output {SCREEN, PDF_FILE, SVG_FILE}\n\tprivate Output outType;\n\n\t// ---------------------------- Processing methods -----------------------------\n\t\n\t/** Initial window settings prior to setup().\n\t */\n\t@Override\n\tpublic void settings()\n\t{ \n\t\tsize(500,500);\n\t\t\n\t\t// Should work with all Processing 3 renderers.\n\t\t//size(500,500, P2D);\n\t\t// size(500,500, P3D);\n\t\t// size(500,500, FX2D);\n\t\t\n\t\tpixelDensity(displayDensity());\t\t// Use platform's maximum display density.\n\t}\n\n\t/** Sets up the sketch.\n\t */\n\t@Override\n\tpublic void setup()\n\t{ \n\t\toutType = Output.SCREEN;\n\t\th = new HandyRenderer(this);\n\t\th.setRoughness(2);\n\t}\n\n\t/** Draws a sketchy circle.\n\t */\n\t@Override\n\tpublic void draw()\n\t{\n\t\tif (outType == Output.SVG_FILE)\n\t\t{\n\t\t\tbeginRecord(SVG, \"sketchyCircle.svg\");\n\t\t\th.setGraphics(recorder);\n\t\t}\n\t\telse if (outType == Output.PDF_FILE)\n\t\t{\n\t\t\tbeginRecord(PDF, \"sketchyCircle.pdf\");\n\t\t\th.setGraphics(recorder);\n\t\t}\n\t\t\t\t\n\t\tbackground(255);\n\t\tstrokeWeight(4);\n\t\tstroke(0);\n\t\t\n\t\th.ellipse(width/2,height/2,width/2,height/2);\n\t\t\n\t\tif (outType != Output.SCREEN)\n\t\t{\n\t\t endRecord();\n\t\t\toutType = Output.SCREEN;\n\t\t\th.setGraphics(this.g);\n\t\t\tloop();\n\t\t}\n\t\telse\n\t\t{\n\t\t\tnoLoop();\n\t\t}\n\t}\n\n\t/** Responds to a key press.\n\t */\n\t@Override\n\tpublic void keyPressed()\n\t{\n\t\tif (key == ' ')\n\t\t{\n\t\t\tloop();\n\t\t}\n\t\telse if ((key == 'p') || (key == 'P'))\n\t\t{\n\t\t\toutType = Output.PDF_FILE;\n\t\t\tloop();\n\t\t}\n\t\telse if ((key == 's') || (key == 'S'))\n\t\t{\n\t\t\toutType = Output.SVG_FILE;\n\t\t\tloop();\n\t\t}\n\t}\n}\n" }, { "path": "Handy/src/org/gicentre/tests/PresetStyleTest.java", "content": "package org.gicentre.tests;\n\nimport org.gicentre.handy.HandyPresets;\nimport org.gicentre.handy.HandyRenderer;\nimport org.gicentre.utils.move.ZoomPan;\n\nimport processing.core.PApplet;\nimport processing.core.PConstants;\nimport processing.core.PFont;\n\n//*****************************************************************************************\n/** Simple sketch to show handy shape drawing in four different present styles. H key toggles\n * sketchy rendering on or off. Left and right arrows change the hachure angle. Image zoomed\n * and panned with mouse drag.\n * @author Jo Wood, giCentre, City University London.\n * @version 2.0, 3rd April, 2016.\n */ \n// *****************************************************************************************\n\n/* This file is part of Handy sketchy drawing library. Handy is free software: you can \n * redistribute it and/or modify it under the terms of the GNU Lesser General Public License\n * as published by the Free Software Foundation, either version 3 of the License, or (at your\n * option) any later version.\n * \n * Handy is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY;\n * without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. \n * See the GNU Lesser General Public License for more details.\n * \n * You should have received a copy of the GNU Lesser General Public License along with this\n * source code (see COPYING.LESSER included with this source code). If not, see \n * http://www.gnu.org/licenses/.\n */\n\npublic class PresetStyleTest extends PApplet \n{\n\t// ------------------------------ Starter method ------------------------------- \n\n\t/** Creates a simple application to test handy line drawing.\n\t * @param args Command line arguments (ignored). \n\t */\n\tpublic static void main(String[] args)\n\t{ \n\t\tPApplet.main(new String[] {\"org.gicentre.tests.PresetStyleTest\"});\n\t}\n\n\t// ----------------------------- Object variables ------------------------------\n\n\tprivate HandyRenderer pencil,marker,water,cPencil, border;\t\n\tprivate ZoomPan zoomer;\n\tprivate float angle;\n\tprivate boolean isHandy;\n\tprivate PFont sketchyFont,normalFont;\n\t\n\t// ---------------------------- Processing methods -----------------------------\n\t\n\t/** Initial window settings prior to setup().\n\t */\n\t@Override\n\tpublic void settings()\n\t{ \n\t\tsize(1200,800);\n\t\t\n\t\t// Should work with all Processing 3 renderers.\n\t\t// size(1200,800, P2D);\n\t\t// size(1200,800, P3D);\n\t\t// size(1200,800, FX2D);\n\t\t\n\t\tpixelDensity(displayDensity());\t\t// Use platform's maximum display density.\n\t}\n\t\n\t/** Sets up the sketch.\n\t */\n\t@Override\n\tpublic void setup()\n\t{\n\t\tzoomer = new ZoomPan(this);\n\t\tangle = -42;\n\t\tisHandy = true;\t\n\t\t\n\t\tpencil = HandyPresets.createPencil(this);\t\t\n\t\twater = HandyPresets.createWaterAndInk(this);\n\t\tmarker = HandyPresets.createMarker(this);\n\t\tcPencil = HandyPresets.createColouredPencil(this);\n\t\tborder = new HandyRenderer(this);\n\t\t\n\t\tpencil.setHachureAngle(angle);\n\t\twater.setHachureAngle(angle);\n\t\tmarker.setHachureAngle(angle);\n\t\tcPencil.setHachureAngle(angle);\n\t\t\n\t\tsketchyFont = loadFont(\"HumorSans-32.vlw\");\n\t\tnormalFont = createFont(\"sans-serif\",32);\n\t}\n\t\n\t\n\t/** Draws the same shapes in four different sketchy styles.\n\t */\n\t@Override\n\tpublic void draw()\n\t{\n\t\tbackground(255);\n\t\tzoomer.transform();\n\t\tpencil.setSeed(1234);\n\t\twater.setSeed(1234);\n\t\tmarker.setSeed(1234);\n\t\tcPencil.setSeed(1234);\n\t\t\t\t\n\t\tstroke(0);\n\t\tstrokeWeight(1);\n\t\ttextAlign(RIGHT,BOTTOM);\n\t\ttextFont(isHandy? sketchyFont:normalFont);\n\t\t\n\t\trandomSeed(10);\n\t\tnoFill();\n\t\tborder.rect(10,10,width/2-20,height/2-20);\n\t\tdrawShapes(pencil,0,0,width/2,height/2);\n\t\tfill(60);\n\t\ttext(\"Pencil\",width/2-20,height/2-15);\n\t\t\n\t\trandomSeed(10);\n\t\tnoFill();\n\t\tborder.rect(width/2+10,10,width/2-20,height/2-20);\n\t\tdrawShapes(water,width/2,0,width/2,height/2);\n\t\tfill(60);\n\t\ttext(\"Ink and watercolour\",width-20,height/2-15);\n\t\t\n\t\trandomSeed(10);\n\t\tnoFill();\n\t\tborder.rect(10,height/2+10,width/2-20,height/2-20);\n\t\tdrawShapes(marker,0,height/2,width/2,height/2);\n\t\tfill(60);\n\t\ttext(\"Marker pen\",width/2-20,height-15);\n\t\t\n\t\trandomSeed(10);\n\t\tnoFill();\n\t\tborder.rect(width/2+10,height/2+10,width/2-20,height/2-20);\n\t\tdrawShapes(cPencil,width/2,height/2,width/2,height/2);\n\t\tfill(60);\n\t\ttext(\"Coloured pencil\",width-20,height-15);\n\t\t\n\t\tnoLoop();\n\t}\n\t\t\n\t/** Allow handy rendering to be toggled on or off and hachure angle to be changed with key presses.\n\t */\n\t@Override\n\tpublic void keyPressed()\n\t{\n\t\tif ((key =='h') || (key == 'H'))\n\t\t{\n\t\t\tisHandy = !isHandy;\n\t\t\tpencil.setIsHandy(isHandy);\n\t\t\twater.setIsHandy(isHandy);\n\t\t\tmarker.setIsHandy(isHandy);\n\t\t\tcPencil.setIsHandy(isHandy);\n\t\t\tloop();\n\t\t}\n\t\telse if ((key == 'r') || (key == 'R'))\n\t\t{\n\t\t\tzoomer.reset();\n\t\t\tloop();\n\t\t}\n\t\t\n\t\tif (key == PConstants.CODED)\n\t\t{\n\t\t\tif (keyCode == PConstants.LEFT)\n\t\t\t{\n\t\t\t\tangle--;\n\t\t\t\tpencil.setHachureAngle(angle);\n\t\t\t\twater.setHachureAngle(angle);\n\t\t\t\tmarker.setHachureAngle(angle);\n\t\t\t\tcPencil.setHachureAngle(angle);\n\t\t\t\t\n\t\t\t\tloop();\n\t\t\t}\n\t\t\telse if (keyCode == PConstants.RIGHT)\n\t\t\t{\n\t\t\t\tangle++;\n\t\t\t\tpencil.setHachureAngle(angle);\n\t\t\t\twater.setHachureAngle(angle);\n\t\t\t\tmarker.setHachureAngle(angle);\n\t\t\t\tcPencil.setHachureAngle(angle);\n\t\t\t\tloop();\n\t\t\t}\n\t\t}\n\t}\n\t\n\t/** Ensures screen is updated whenever a zooming/panning mouse is dragged.\n\t */\n\t@Override\n\tpublic void mouseDragged()\n\t{\n\t\tloop();\n\t}\n\t\n\t/** Draws a range of shapes at random positions on the screen.\n\t * @param handy Renderer to do the drawing.\n\t * @param x Left hand edge of drawing area\n\t * @param y Top of drawing area\n\t * @param w Width of drawing area.\n\t * @param h Height of drawing area.\n\t */\n\tprivate void drawShapes(HandyRenderer handy, float x, float y, float w, float h)\n\t{\n\t\tfloat minSize = w/10;\n\t\tfloat maxSize = Math.min(w,h)/4;\n\t\t\t\n\t\tfor (int i=0; i<30; i++)\n\t\t{\n\t\t\tint colour = color(random(100,200),random(60,200), random(100,200),120);\n\t\t\tfill(colour);\n\t\t\tfloat shapeChoice = random(0,1);\n\t\t\tif (shapeChoice < 0.33)\n\t\t\t{\n\t\t\t\thandy.rect(x+random(minSize,w-maxSize),y+random(minSize,h-maxSize),random(minSize,maxSize), random(minSize,maxSize));\n\t\t\t}\n\t\t\telse if (shapeChoice <0.66)\n\t\t\t{\n\t\t\t\tfloat x1 = x+random(minSize,w-maxSize);\n\t\t\t\tfloat y1 = y+random(minSize,h-maxSize);\n\t\t\t\tfloat x2 = x1+random(50,maxSize);\n\t\t\t\tfloat y2 = y1+random(-10,10);\n\t\t\t\tfloat x3 = (x1+x2)/2;\n\t\t\t\tfloat y3 = y1+random(-minSize,-maxSize);\n\t\t\t\thandy.triangle(x1,y1,x2,y2,x3,y3);\t\n\t\t\t}\n\t\t\telse\n\t\t\t{\n\t\t\t\thandy.ellipse(x+random(minSize,w-maxSize), y+random(minSize,h-maxSize),random(minSize,maxSize), random(minSize,maxSize));\t\n\t\t\t}\n\t\t\t\n\t\t}\n\t\t\n\n\t}\n}\n" }, { "path": "Handy/src/org/gicentre/tests/PrototypeTest.java", "content": "package org.gicentre.tests;\n\nimport org.gicentre.handy.HandyRenderer;\nimport org.gicentre.utils.colour.ColourTable;\n\nimport processing.core.PApplet;\nimport processing.core.PFont;\n\n\n//*****************************************************************************************\n/** Sketch to illustrate the use of the HandyRenderer to build a digital prototype.\n * @author Jo Wood, giCentre, City University London.\n * @version 2.0, 3rd April, 2016\n */ \n// *****************************************************************************************\n\n/* This file is part of Handy sketchy drawing library. Handy is free software: you can \n * redistribute it and/or modify it under the terms of the GNU Lesser General Public License\n * as published by the Free Software Foundation, either version 3 of the License, or (at your\n * option) any later version.\n * \n * Handy is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY;\n * without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. \n * See the GNU Lesser General Public License for more details.\n * \n * You should have received a copy of the GNU Lesser General Public License along with this\n * source code (see COPYING.LESSER included with this source code). If not, see \n * http://www.gnu.org/licenses/.\n */\n\npublic class PrototypeTest extends PApplet \n{\n\t// ------------------------------ Starter method ------------------------------- \n\n\t/** Creates a simple application to test handy line drawing.\n\t * @param args Command line arguments (ignored). \n\t */\n\tpublic static void main(String[] args)\n\t{ \n\t\tPApplet.main(new String[] {\"org.gicentre.tests.PrototypeTest\"});\n\t}\n\n\t// ----------------------------- Object variables ------------------------------\n\n\tprivate HandyRenderer h;\n\tprivate PFont largeFont, mediumFont, smallFont;\n\t\n\tprivate ColourTable mapColours;\n\t\t\n\t// ---------------------------- Processing methods -----------------------------\n\t\n\t/** Initial window settings prior to setup().\n\t */\n\t@Override\n\tpublic void settings()\n\t{ \n\t\tsize(930,630);\n\t\t\n\t\t// Should work with all Processing 3 renderers.\n\t\t// size(930,630, P2D);\n\t\t// size(930,630, P3D);\n\t\t// size(930,630, FX2D);\n\t\t\n\t\tpixelDensity(displayDensity());\t\t// Use platform's maximum display density.\n\t}\n\t\n\t/** Sets up the sketch.\n\t */\n\t@Override\n\tpublic void setup()\n\t{ \t\t\n\t\tlargeFont = loadFont(\"HumorSans-32.vlw\");\n\t\tmediumFont = loadFont(\"HumorSans-18.vlw\");\n\t\tsmallFont = mediumFont;\n\t\tmapColours = ColourTable.getPresetColourTable(ColourTable.PU_OR,0,1);\n\t\t\n\t\th = new HandyRenderer(this);\n\t}\n\t\n\t/** Draws the prototypes.\n\t */\n\t@Override\n\tpublic void draw()\n\t{\n\t\tbackground(245,235,220);\n\t\t\n\t\tstroke(0,40);\n\t\tfill(255);\n\t\th.setFillGap(0);\n\t\th.setRoughness(0.5f);\n\t\th.rect(10,10,width-20,height-20);\n\t\t\n\t\t// Left hand Likert area\n\t\th.rect(20,20, 200, height-40);\n\t\t\n\t\t// Middle map area\n\t\th.rect(240, 20, 480, height-40);\n\t\t\t\t\n\t\t// Right hand demographics area\n\t\th.rect(740,20,170,height-40);\n\t\t\n\t\t// Likert graphs\n\t\tdrawLikert(\"Local area\", 30, 30, 180, 105);\n\t\tdrawLikert(\"Public services\", 30, 145, 180, 105);\n\t\tdrawLikert(\"Public involvment\", 30, 260, 180, 105);\n\t\tdrawLikert(\"The community\", 30, 375, 180, 105);\n\t\tdrawLikert(\"Access to services\",30, 490, 180, 105);\n\t\t\n\t\t// Treemap / map area\n\t\th.setRoughness(1);\n\t\ttextFont(mediumFont);\n\t\th.setFillGap(6);\n\t\tstroke(0,30);\n\t\ttextAlign(CENTER,CENTER);\n\t\tfill(mapColours.findColour(0.8f));\n\t\th.rect(250, 30, 140,160);\n\t\tfill(0,140);\n\t\ttext(\"North West\\nLeicestershire\",320,95);\n\t\t\n\t\tfill(mapColours.findColour(0.6f));\n\t\th.rect(400, 30, 210,160);\n\t\tfill(0,140);\n\t\ttext(\"Charnwood\",505,95);\n\t\t\n\t\tfill(mapColours.findColour(0.7f));\n\t\th.rect(620, 30, 90,160);\n\t\tfill(0,140);\n\t\ttext(\"Melton\",665,95);\n\t\t\n\t\tfill(mapColours.findColour(0.3f));\n\t\th.rect(250, 200, 120,160);\n\t\tfill(0,140);\n\t\ttext(\"Hinckley &\\nBosworth\",310,280);\n\t\t\n\t\tfill(mapColours.findColour(0.6f));\n\t\th.rect(380, 200, 120,160);\n\t\tfill(0,140);\n\t\ttext(\"Blaby\",440,280);\n\t\t\n\t\tfill(mapColours.findColour(0.4f));\n\t\th.rect(510, 200, 70,160);\n\t\tfill(0,140);\n\t\ttext(\"Oadby &\\nWigston\",545,280);\n\t\t\n\t\tfill(mapColours.findColour(0.8f));\n\t\th.rect(590, 200, 120,160);\n\t\tfill(0,140);\n\t\ttext(\"Harborough\",650,280);\n\t\t\n\t\t\n\t\t// Map legend and titles\n\t\th.setRoughness(0.5f);\n\t\th.setFillGap(2);\n\t\tstroke(0,40);\n\t\tfor (int i=0; i<20; i++)\n\t\t{\n\t\t\tfloat x = map(i,0,20, 250, 710);\n\t\t\tfloat y = 400;\n\t\t\tfloat wdth = 460/20;\n\t\t\tfloat hght = 20;\n\t\t\tfill(mapColours.findColour(i/20f));\n\t\t\th.rect(x,y,wdth,hght);\n\t\t}\n\t\tfill(0,200);\n\t\ttextSize(16);\n\t\ttextFont(mediumFont);\n\t\ttextAlign(LEFT);\n\t\ttext(\"Negative response\",250,440);\n\t\ttextAlign(RIGHT);\n\t\ttext(\"Positive response\",710,440);\n\t\t\n\t\ttextSize(32);\n\t\ttextFont(largeFont);\n\t\ttextSize(32);\n\t\ttextAlign(CENTER);\n\t\tfill(0,150);\n\t\ttext(\"Question title here\",(710+250)/2,530);\n\t\t\n\t\ttextSize(16);\n\t\ttextFont(mediumFont);\n\t\tfill(0,200);\n\t\ttext(\"Advanced menu options and status displayed here\",(710+250)/2,605);\n\t\t\n\t\t\n\t\t// Demographics bars\n\t\tfloat yPos = drawDemographic(\"Gender\", 3, 745, 30, 160);\n\t\tyPos = drawDemographic(\"Age\", 9, 745, yPos+10, 160);\n\t\tyPos = drawDemographic(\"Health\", 5, 745, yPos+10, 160);\n\t\tyPos = drawDemographic(\"Occupancy\", 5, 745, yPos+10, 160);\n\t\tyPos = drawDemographic(\"Disability\", 3, 745, yPos+10, 160);\n\t\tyPos = drawDemographic(\"Ethnicity\", 3, 745, yPos+10, 160);\n\t\tyPos = drawDemographic(\"Years resident\", 5, 745, yPos+10, 160);\n\t\t\n\t\th.setFillGap(1);\n\t\tfill(0,140);\n\t\ttextAlign(RIGHT,CENTER);\n\t\ttext(\"Everyone\",745+34,height-38);\n\t\t\n\t\tfill(172,117,116);\n\t\tfloat barLength = (160-40);\n\t\th.rect(745+40,height-40,barLength,9);\n\t\t\n\t\tnoLoop();\n\t}\n\t\t\n\t/** Redraw on any key press.\n\t */\n\t@Override\n\tpublic void keyPressed()\n\t{\n\t\tloop();\n\t}\n\t\n\t/** Draws one of the horizontal bar charts representing a demographic variable.\n\t * @param title Title of chart\n\t * @param numBars Number of bars to draw.\n\t * @param x Left hand edge of bar area\n\t * @param y Top edge of bar area.\n\t * @param wdth Maximum width of bar area.\n\t * @return The y position of the newly created bar area.\n\t */\n\tprivate float drawDemographic(String title, int numBars, float x, float y, float wdth)\n\t{\n\t\tfloat barWidth = 9;\n\t\tfloat yPos = y;\n\t\t\n\t\tfill(0,140);\n\t\ttextSize(18);\n\t\ttextFont(mediumFont);\n\t\tstroke(0,50);\n\t\ttextAlign(LEFT,CENTER);\n\t\ttext(title,x+40,yPos);\n\t\tyPos += 12;\n\t\t\n\t\n\t\ttextFont(smallFont);\n\t\ttextSize(12);\n\t\tfor (int i=0; i 0.01) \n\t\t{ \n\t\t\txmag -= diff/4.0; \n\t\t}\n\n\t\tdiff = ymag-newYmag;\n\t\tif (abs(diff) > 0.01) \n\t\t{ \n\t\t\tymag -= diff/4.0; \n\t\t}\n\n\t\trotateX(-ymag); \n\t\trotateY(-xmag); \n\t\t\t\t\t\t\n\t\th.beginShape(QUADS); \n\t\t h.vertex(-lengthA, lengthA, lengthB);\n\t\t h.vertex( lengthA, lengthA, lengthB);\n\t\t h.vertex( lengthA, -lengthA, lengthB);\n\t\t h.vertex(-lengthA, -lengthA, lengthB);\n\n\t\t h.vertex( lengthA, lengthA, lengthB);\n\t\t h.vertex( lengthA, lengthA, -lengthB);\n\t\t h.vertex( lengthA, -lengthA, -lengthB);\n\t\t h.vertex( lengthA, -lengthA, lengthB);\n\t\t \n\t\t h.vertex( lengthA, lengthA, -lengthB);\n\t\t h.vertex(-lengthA, lengthA, -lengthB);\n\t\t h.vertex(-lengthA, -lengthA, -lengthB);\n\t\t h.vertex( lengthA, -lengthA, -lengthB);\n\t\t \n\t\t h.vertex(-lengthA, lengthA, -lengthB);\n\t\t h.vertex(-lengthA, lengthA, lengthB);\n\t\t h.vertex(-lengthA, -lengthA, lengthB);\n\t\t h.vertex(-lengthA, -lengthA, -lengthB);\n\n\t\t h.vertex(-lengthA, lengthA, -lengthB);\n\t\t h.vertex( lengthA, lengthA, -lengthB);\n\t\t h.vertex( lengthA, lengthA, lengthB);\n\t\t h.vertex(-lengthA, lengthA, lengthB);\n\t\t \n\t\t h.vertex(-lengthA, -lengthA, -lengthB);\n\t\t h.vertex( lengthA, -lengthA, -lengthB);\n\t\t h.vertex( lengthA, -lengthA, lengthB);\n\t\t h.vertex(-lengthA, -lengthA, lengthB);\n\t\th.endShape();\n\t\t \n\t\t// Pencil guide lines.\n\t\th.setStrokeWeight(2);\n\t\th.setStrokeColour(color(0,100));\n\t\th.line(-lengthA*overshoot,lengthA,lengthB, lengthA*overshoot,lengthA,lengthB);\n\t\th.line( lengthA,lengthA*overshoot, lengthB, lengthA, -lengthA*overshoot, lengthB);\n\t\th.line( lengthA*overshoot, -lengthA, lengthB,-lengthA*overshoot, -lengthA, lengthB);\n\t\th.line(-lengthA, -lengthA*overshoot, lengthB,-lengthA, lengthA*overshoot, lengthB);\n\n\t\th.line( lengthA, lengthA, lengthB*overshoot, lengthA, lengthA, -lengthB*overshoot);\n\t\th.line( lengthA, lengthA*overshoot, -lengthB, lengthA, -lengthA*overshoot, -lengthB);\n\t\th.line( lengthA, -lengthA, -lengthB*overshoot, lengthA, -lengthA, lengthB*overshoot);\n\n\t\th.line( lengthA*overshoot, lengthA, -lengthB,-lengthA*overshoot, lengthA, -lengthB);\n\t\th.line(-lengthA, lengthA*overshoot, -lengthB,-lengthA, -lengthA*overshoot, -lengthB);\n\t\th.line(-lengthA*overshoot, -lengthA, -lengthB, lengthA*overshoot, -lengthA, -lengthB);\n\n\t\th.line(-lengthA, lengthA, -lengthB*overshoot,-lengthA, lengthA, lengthB*overshoot);\n \t\th.line(-lengthA, -lengthA, lengthB*overshoot,-lengthA, -lengthA, -lengthB*overshoot);\t\n\n\t\tpopMatrix(); \n\t}\n\n\t@Override\n\tpublic void keyPressed()\n\t{\n\t\tif ((key =='h') || (key == 'H'))\n\t\t{\n\t\t\tisHandy = !isHandy;\n\t\t\th.setIsHandy(isHandy);\n\t\t}\n\t\t\n\t\telse if ((key == 'a') || (key == 'A'))\n\t\t{\n\t\t\tangle++;\n\t\t\th.setHachureAngle(angle);\n\t\t}\n\n\t\tif (key == PConstants.CODED)\n\t\t{\n\t\t\tif (keyCode == PConstants.UP)\n\t\t\t{\n\t\t\t\troughness *= 1.1;\n\t\t\t\th.setRoughness(roughness);\n\t\t\t}\n\t\t\telse if (keyCode == PConstants.DOWN)\n\t\t\t{\n\t\t\t\troughness *= 0.9;\n\t\t\t\th.setRoughness(roughness);\n\t\t\t}\n\t\t\telse if ((keyCode == PConstants.LEFT) && (overshoot > 1))\n\t\t\t{\n\t\t\t\tovershoot *= 0.99;\n\t\t\t}\n\t\t\telse if (keyCode == PConstants.RIGHT)\n\t\t\t{\n\t\t\t\tovershoot *= 1.01;\n\t\t\t}\n\t\t}\n\t}\n}" }, { "path": "README.md", "content": "# handy\nHand-drawn sketchy rendering in [Processing](http://processing.org).\n\n![alt text](http://gicentre.org/handy/images/handy.jpg \"Sketchy rendering in Processing\")\n" } ]